# Sending manual emails

One of the key features of Jira Email This Issue is sending manual emails right from the Jira issue's screen.&#x20;

To send a manual email, do either of the following:

* Click the **Email** button on the right side of the issue screen.
* Under **More**, choose the **Email This Issue** item from the menu.
* Press Q.

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FjZ4ec3C8NA3ruUeZnSJi%2Foutgoing_01.jpg?alt=media\&token=4bfb75d3-9194-4c2b-9a4f-6f7d01198161)

{% hint style="info" %}
**Note**: Email templates, and SMTP server settings don't need to be set each time. However, if the default settings are not enough, you can define manual email configuration sets that override the defaults and allow you to fully customize how you want to send emails manually.&#x20;

For more information about setting up an SMTP server, see [Outgoing mail connections](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/administration/outgoing-mail-connections).

For customizing default settings, see [Manual email default settings](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/sending-manual-emails/manual-email-default-settings), [Email issue filters](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/sending-issue-filters-by-email), [Email Templates](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/email-templates).

To learn more about the default procedure of sending them from the issue, read forward.
{% endhint %}

### Email screen actions <a href="#emailbuttonandemailscreen-composeyouremailseasily" id="emailbuttonandemailscreen-composeyouremailseasily"></a>

The email screen is where you can compose emails manually the following way:

* Set recipients (To, Cc, Bcc). Recipients can be users, roles, groups, custom fields, external email addresses and virtual users (e.g. project lead, watchers, assignee, reporter).
* Set recipient lists  - comma-separated email addresses can be copied and pasted to the Address list fields (To, CC or BCC)
* Enter an email subject and email body.
* Add attachments to the email.
* Choose from predefined messages to add complex content to the email body.

On the right side of the email screen you can see the issue details on the right hand side for easy reference, therefore there is no need to open the issue in a separate tab of the browser.

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FXL2OYtsSVEKxu9wwEsaa%2Foutgoing_02.jpg?alt=media\&token=3b3a91c5-c1c2-4404-bc56-a370703cf467)

#### Email options <a href="#emailbuttonandemailscreen-options" id="emailbuttonandemailscreen-options"></a>

While composing your email, you can set various email options. Click the **Email options** button on top to reveal or hide them on the right side panel of the screen.

<figure><img src="https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FGgaUTysKpH5KGyVkLmty%2Fimage.png?alt=media&#x26;token=1ec41153-3c34-44fa-a9e0-881b61913850" alt=""><figcaption></figcaption></figure>

#### The email body <a href="#emailbuttonandemailscreen-initializeemailbodywithprefilltemplates" id="emailbuttonandemailscreen-initializeemailbodywithprefilltemplates"></a>

You can compose an individual message in the editor or you can fill the email body with predefined content. Choose the predefined response from the drop-down list, and click **Add Response** for it to appear in the body.

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FEvshs3UbKrTKJNOyrLok%2Fimage.png?alt=media\&token=298b25ee-8a89-4969-92df-d3a1ea27749d)

To initialize the email body, you need to develop an email template first under **Templates** and when adding a new or editing and already existing **Context,** select it the **Mail Body Initializer Template** field. Read more about it [here](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/email-templates/using-mail-body-initializer-templates).

See [Email templates](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/email-templates), [Contexts](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/contexts) and [Email editors and Rich Text emails](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/sending-manual-emails/the-difference-between-email-editors) for more information.&#x20;

{% hint style="warning" %}
**Important**: Never use the same templates to prefill body and send emails. Mail Body Initializer templates are purely used to initialize the Body field in the email screen. When the email is sent, the formatted, preinitialized and possibly modified Body will be submitted as if it was entered manually.

Therefore the template used for generating the final email will include this formatted, rich body value via the `$!mailBody` variable. This means, if you used the same template, the preformatted content may be added twice to the email.&#x20;

If you use a prefill template, the email template you send with may be as simply as the `$!mailBody` variable.
{% endhint %}

#### Large images in the email body

{% hint style="warning" %}
When adding large inline images to the email body please wait until the uploading progress bar reaches 100% and then **fully disappears** before clicking on the **Send** button. \
In case of clicking **Send** earlier 500 - internal server error occurs.
{% endhint %}

![Progress bar should fully disappear before sending an email](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2F0p2xOC8lhF3BP1Li4FuP%2Fimage.png?alt=media\&token=9a9e5512-c813-4c78-ac7c-dea0dcd904b4)

When using **Reply/ Reply all / Forward** function to send emails containing large inline image(s) loading the Manual Email screen might take up to a few minutes depending on the inline image's size.&#x20;

#### The Email Template field

The email template used for formatting email is determined by the project and/or the type of the issue (via Contexts) and can be easily configured using the built-in template editor.

Contexts may be configured with multiple template categories. Templates from the selected categories are listed in the email screen. Emails are generated from the selected template.

See [Email templates](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/email-templates), [Contexts](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/contexts) and [Email editors and Rich Text emails](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/sending-manual-emails/the-difference-between-email-editors) for more information.&#x20;

#### The Subject field

Clicking the refresh button next to the Subject field regenerates the subject according to the template. Once clicked, the page will reload to display the content generated by using the selected template.

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FGteWFXrfKBS7MXEZYtK8%2Fimage.png?alt=media\&token=e79bd01c-bbfe-4a6b-a275-e8f3807d213d)

See [Email templates](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/email-templates), [Contexts](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/contexts) and [Email editors and Rich Text emails](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/sending-manual-emails/the-difference-between-email-editors) for more information.&#x20;

#### Attachments <a href="#emailbuttonandemailscreen-attachments" id="emailbuttonandemailscreen-attachments"></a>

You can select the issue attachments you want to attach to the email either in the text editor, or in the **Attachments** field.

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FgLAoZKK71DzcoF3krEwa%2Foutgoing_04.jpg?alt=media\&token=2ee5a193-6a65-4835-bc29-5b39ef7c5591)

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2Frt1QYsRtcAekWoFahs3M%2Foutgoing_05.jpg?alt=media\&token=f598ff84-447d-4cdd-82ae-32a6e7ca3348)

You can also add additional files to your email for your recipients to receive all necessary information in the **Attach more files** field.&#x20;

#### Quote comments in mail body <a href="#emailbuttonandemailscreen-quotecommentsinmailbody" id="emailbuttonandemailscreen-quotecommentsinmailbody"></a>

The right hand side of the email screen shows the issue details including the comments visible to the current user. Comments may be quoted in the mail body with a single click.

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FaLLm5UkOGu5CitQi7Jet%2Foutgoing_06.jpg?alt=media\&token=2a4c6dd6-7513-41f7-9c27-d9e8e1ed9d7e)

#### Email preview <a href="#emailbuttonandemailscreen-previewemails" id="emailbuttonandemailscreen-previewemails"></a>

Once you have composed your email recipients, subject, body and options, you can preview what the email will look like for the recipients.

To preview, click the **Preview** button at the bottom.&#x20;

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2Fpr44kdBoMbgAg10GX1T4%2Foutgoing_09.jpg?alt=media\&token=4c6c244a-20f2-4398-a6e4-3d14d4fa714a)

{% hint style="info" %}
**Note**: Email recipients are resolved to email addresses.
{% endhint %}

#### The Send & Remember settings button

Email options are preset from the global defaults, but can be overridden using the **Send & Remember settings** button. These user preferences are reused next time you send emails.

{% hint style="info" %}
**Note**: These preferences used to be stored in Browser cookies. Since <mark style="color:green;">Version 8.1.0</mark>, user preferences are stored in the database so they are not lost if users change browsers or clear browser caches.
{% endhint %}

If you choose, **Send & Remember settings**, the email recipient configuration is also stored and reused next time.

### Executing workflow transitions <a href="#emailbuttonandemailscreen-executeworkflowtransitions" id="emailbuttonandemailscreen-executeworkflowtransitions"></a>

Jira Email This Issue for Server supports the execution of workflow transitions right after sending emails manually. To activate this feature, the Jira administrator must prepare the workflow.

Transitions marked by a transition property `jeti.on.send.email.transition` with the value `true` are execute&#x64;*.*&#x20;

* If no transitions are marked in the current status, no transitions are executed automatically.
* If only one transition is marked in the current status, this transition is executed automatically.
* If multiple transitions are marked in the current status, when sending the email a popup screen is shown to select the transition to be executed. Skip transitions by selecting **Send Email Only**.

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FpkjZMrQcWWliJ7l7ulW0%2Foutgoing_10.jpg?alt=media\&token=c717ba56-8d66-402a-9228-c9acb0a6932e)

{% hint style="info" %}
**Note**: Keep the following in mind:

* The transition screen is not shown unless the transition is configured to show a pop-up window.
* Conditions are not bypassed, and validators are applied.
* The selected transition is executed **after** the email is sent. The failure to send the email skips the transition. Although, the failure to execute a transition does not prevent the emails from being sent.&#x20;
  {% endhint %}

{% hint style="info" %}
**Note**: It is a good practice to add transitions to the workflow statuses that are hidden from the user interface and are executed only when emails are sent.
{% endhint %}

For more information, see [Workflow post functions](https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/workflow-post-functions).
