Email This Issue
📈 Marketplace❓ Support❤️ Feedback🏠 META-INF Apps
Email This Issue - for Jira Cloud
Email This Issue - for Jira Cloud
  • ⬇️Overview
  • Email This Issue - for Jira Cloud
  • Features
  • How Email This Issue Works
  • Secure the email channel with Email This Issue
  • Comparing Email This Issue and Jira Cloud
  • 📤Outgoing Emails
    • Outgoing emails overview
    • Manual emails
      • Configuring manual emails
      • Sending manual emails
    • Email notification schemes and email notifications
    • Workflow post functions
    • Advanced email configuration
    • Customizing email templates
    • Canned Responses (default messages)
    • Scope evaluation
  • 📥Incoming Emails (Mail Handlers)
    • Incoming emails overview
  • Mail handlers - adding / editing
    • General handler settings
    • Filtering
    • Finding issues
    • Setting up rules and actions in the actions editor
      • Adding/editing actions
      • Adding recipients to Request Participants
      • Creating an issue
      • Updating an issue
      • Setting field values
      • Adding comments
      • Sending auto-reply emails
      • Executing workflow transitions
      • Creating a customer
      • Using split regexp
      • Conditions
      • Approve request
      • Decline request
    • Maintaining email chains
    • Mail Handler New UI
  • Global Sender Address Filters
  • Attachment Filters
    • Regular Attachment Handling Deprecation
  • 🤓Administration
    • Outgoing Mail Connections
    • Alerting via Webhooks
      • Webhooks
        • Configuring Slack to receive alerts via webhooks
        • Configuring OpsGenie to Receive alerts via webhooks
        • Configuring Microsoft Teams to receive alerts via webhooks
      • Webhook execution logs
    • Mail Queue
    • Email Audit Log
    • Permissions
    • Recipient Restrictions
    • Incoming Mail Connections
    • Email Security
    • Incoming Mail Queue
    • Incoming Mail Log
    • OAuth2 Credentials
      • Enabling OAuth2 Authorization in your Google Account
      • Enabling OAuth2 Authorization in your Microsoft 365 Account
      • Troubleshooting guides for Microsoft OAuth2 Connections
        • How to fix "BAD User is authenticated but not connected" error​
        • How to fix "401 Unauthorized" error
        • How to fix "key expires_in " error
        • How to fix "Need admin approval" error
  • ☁️Server to Cloud Migration
    • 🛫Server to Cloud - Automatic Migration tool
      • Preparing for the migration
      • Doing the migration
      • Finalizing the migration in Cloud
      • Migration with unsupported Jira versions causes errors
    • Server to Cloud - Manual migration guide for Email This Issue
  • ❓FAQ
    • No recipients error in outgoing emails
    • How-to add custom macro to email Template?
    • Why cannot I select custom event types in notification?
    • How to configure the Email This Issue addon user in Jira Cloud?
    • I get an error: Could not create request on behalf of the sender
    • Why is the Incoming Mail Queue size limited?
    • Outgoing mail not sent - Read timeout error
    • Access restriction icon is not appearing when adding internal attachments via Email this Issue
  • 🌪️General
    • Release Notes
    • API
      • API for Velocity Context Objects - 1.7
      • API for Velocity Context Objects
    • Addon Pages
      • Integrity Check
      • Feedback and Support
    • Security Advisories
      • Email This Issue Security Advisory September 28, 2020
    • Appendix
      • Supported Time Zones
    • Integration of Glass Documentation
Powered by GitBook
On this page
  • Setting up Scope
  • Setting up Email Settings
  • Setting up Advanced settings

Was this helpful?

  1. Outgoing Emails

Advanced email configuration

PreviousWorkflow post functionsNextCustomizing email templates

Last updated 1 month ago

Was this helpful?

Advanced email configurations provide a set of optional features that can be useful with more complex scenarios.

1. To see the list of the list of advanced email configurations, go to the Outgoing Mails configuration tab and select Advanced Email Configuration under GENERAL CONFIGURATION.

2. Add a new configuration by clicking on the Add button.

3. Edit existing ones by clicking on the three dots and choosing Edit.

Note: It is possible to add multiple advanced email configurations. Consider these aspects in each case:

  • Scope

  • Email Settings

  • Advanced

Setting up Scope

The scope determines to which issues this setting is applicable. If there are multiple manual email configurations in the system, Email This Issue evaluates all of them and determines the one with the best matching scope for the issue.

The scope can consist of:

  • 0 or more projects

  • 0 or more issue types

  • An optional JQL query

  • An email trigger

To enter a JQL which involves a user name (such as defining the assignee of an issue), follow these steps:

  1. Under the JQL Filter field, click Edit.

  2. Enter the JQL.

  3. When it comes to entering a user name, do the following:

    1. Click Insert user.

    2. Search for the user name, then click on Insert to insert a string.

  4. Click Save to use the JQL or Cancel to delete it.

Setting up Email Settings

In the Email Settings tab, the following advanced attributes are available:

Field

Value

Definition

Store non-Jira Recipients

Text custom field

Select a Text custom field here to store external email addresses of each outgoing email separated with commas.

Use this field in email notification schemes to send automated emails. This way the field selected here may be considered as a field for external watchers.

Store User Recipients

Multi User Picker custom field

Select a Multi User Picker field here to store Jira user recipients of each outgoing email sent in the scope of this Advanced Email Configuration

Store first sent email time

Date Time Picker custom field

Select a Date Time Picker field here to store the first sent email's sent time.

First sent email's sent time is determined by the email audit log. This means that the value will always be the sent time of the first email, not the first emails sent after this field has been set.

From Name Pattern

Velocity-enabled name pattern

This pattern allows to dynamically generate From Name attribute in the outgoing emails.

An example: $!issue.project.name Hotline renders the From name based on the issue's project name and will append the word "Hotline".

From Email Address Pattern

Velocity-enabled email address pattern

A pattern that evaluates to a valid email address and is used as from address in the email.

Use this field to dynamically generate the From Email Address of the outgoing emails.

Reply-To Email Address Pattern

Velocity-enabled email address pattern

A pattern that evaluates to a valid email address and is used as reply-to address in the email.

Use this field to dynamically generate the Reply-To Email Address of the outgoing emails.

BCC Address

Valid email address

Email address entered here receives all outgoing emails sent via Email This Issue.

Setting up Advanced settings

Embedding policy: Configure how to send out attachments. It has the following options:

  • Embed if attachment belongs to this Jira: selecting this option will cause that all attachments (images and non-images) will be sent as part of the email.

  • Do not embed images at all: If you select this option, then links in the email will not be loaded, and target attachments will not be sent.

Add Bulk header: Configure whether to add the "Precedence:" bulk header to outgoing emails. It is a good practice to add this header to the emails, so that auto responds (e.g. out of office replies) aren't sent in reply to these emails.

Add auto-generated header: Configure whether to add the "Auto-Submitted:" auto-generated header to the emails. This header indicates that the message was originated by an automatic process.

Use default SMTP: Email This Issue can be configured with multiple . Select the one to use to send emails, or enable "Use default SMTP" to always use the SMTP server marked as default.

Override this setting as described in on the page

📤
SMTP Servers
Customizable Email Templates
HTML Body Template
Advanced Email Configuration
Scope
Email Settings
Advanced