# Advanced email configuration

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**.

<figure><img src="https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FvDbhTnDQp9Mu9M3Zr2FX%2Fadvanced_1.png?alt=media&#x26;token=c3a327d7-982d-4128-9795-afa8bd079c79" alt=""><figcaption><p>Advanced Email Configuration</p></figcaption></figure>

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

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

{% hint style="info" %}
Note: It is possible to add multiple advanced email configurations. Consider these aspects in each case:

* **Scope**
* **Email Settings**&#x20;
* **Advanced**
  {% endhint %}

## **Setting up** Scope <a href="#advancedemailconfiguration-scope" id="advancedemailconfiguration-scope"></a>

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&#x20;
* 0 or more issue types
* An optional JQL query
* An email trigger

<figure><img src="https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2Fcoo82pA0NCEoccfNUyjk%2Fadvanced_2.png?alt=media&#x26;token=3e76641e-e187-49cc-8071-2311048d30ce" alt=""><figcaption><p>Scope</p></figcaption></figure>

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. &#x20;Click **Insert user**.&#x20;
   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 <a href="#advancedemailconfiguration-emailsettings" id="advancedemailconfiguration-emailsettings"></a>

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

| Field                          | Value                                  | Definition                                                                                                                                                                                                                                                                                          |
| ------------------------------ | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Store non-Jira Recipients      | Text custom field                      | <p>Select a Text custom field here to store external email addresses of each outgoing email separated with commas.</p><p>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.</p>            |
| 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          | <p>Select a Date Time Picker field here to store the first sent email's sent time.</p><p>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.</p> |
| From Name Pattern              | Velocity-enabled name pattern          | <p>This pattern allows to dynamically generate From Name attribute in the outgoing emails.</p><p>An example: <code>$!issue.project.name Hotline</code> renders the From name based on the issue's project name and will append the word "Hotline".</p>                                              |
| From Email Address Pattern     | Velocity-enabled email address pattern | <p>A pattern that evaluates to a valid email address and is used as from address in the email.</p><p>Use this field to dynamically generate the From Email Address of the outgoing emails.</p>                                                                                                      |
| Reply-To Email Address Pattern | Velocity-enabled email address pattern | <p>A pattern that evaluates to a valid email address and is used as reply-to address in the email.</p><p>Use this field to dynamically generate the Reply-To Email Address of the outgoing emails.</p>                                                                                              |
| BCC Address                    | Valid email address                    | Email address entered here receives all outgoing emails sent via Email This Issue.                                                                                                                                                                                                                  |

<figure><img src="https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FlJkS4GJnCxuRBrvYkpN0%2Fadvanced_3.png?alt=media&#x26;token=d2a8986e-6c59-424c-becf-32cbe338eb26" alt=""><figcaption><p>Email Settings</p></figcaption></figure>

## **Setting up** Advanced settings

<figure><img src="https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FtIGS9td0hZvr80YjcN8E%2Fadvanced_4.png?alt=media&#x26;token=2f69e742-65c8-4e47-894d-304bc59f9d2e" alt=""><figcaption><p>Advanced</p></figcaption></figure>

**Use default SMTP:** Email This Issue can be configured with multiple [SMTP Servers](https://docs.meta-inf.hu/email-this-issue/administration/email-this-issue-for-jira-cloud-smtp-servers). Select the one to use to send emails, or enable "Use default SMTP" to always use the SMTP server marked as default.

**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.

Override this setting as described in [HTML Body Template](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-cloud-customizable-email-templates#CustomizableEmailTemplates-HTMLBodyTemplate) on the [Customizable Email Templates](https://docs.meta-inf.hu/email-this-issue/outgoing-emails/email-this-issue-for-jira-cloud-customizable-email-templates) page

**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 **"**&#x41;uto-Submitted:**"** auto-generated header to the emails. This header indicates that the message was originated by an automatic process.