# Customizing the email template used with manual emails

This section explains how to customize the Email This Issue template used when you are manually editing and sending notifications using the **Email** button. Read more [here](/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/sending-manual-emails.md).

## Before you begin <a href="#customizethetemplateusedbyemailbutton-prerequisites" id="customizethetemplateusedbyemailbutton-prerequisites"></a>

This tutorial require*s* the following prerequisites to be met:

* The Email This Issue add-on is installed in Jira. Read more [here](https://confluence.atlassian.com/upm/installing-add-ons-273875715.html).
* A license key is saved in Jira.
* You have an SMTP server configured in Jira. Read more [here](https://confluence.atlassian.com/adminjiraserver071/configuring-jira-s-smtp-mail-server-to-send-notifications-802592930.html).

{% hint style="info" %}
**Note**: You must be a **Jira administrator** to be able to perform the following settings.
{% endhint %}

## Objectives <a href="#customizethetemplateusedbyemailbutton-objectives" id="customizethetemplateusedbyemailbutton-objectives"></a>

By following this guide you will be able to carry out the following actions:

1\. Customize the email templates used by Jira Email this Issue.

2\. Test the template. (optional)

2\. Associate the template with your projects and/or issue types

## Procedure <a href="#customizethetemplateusedbyemailbutton-step-by-stepguide" id="customizethetemplateusedbyemailbutton-step-by-stepguide"></a>

### Customizing the template

1\. Go to **Email Templates** under **OUTGOING EMAILS and click** the **Add** button then choose from the following options:

* Create from Themes
* Create from JIRA Templates

![](/files/UBzkz1yaDdwo0CiVyG4T)

Read more [here](/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/email-templates.md).

2\. Customize the template according to your needs. Use the field picker to add issue fields and custom fields, comments or issue linking information.<br>

![](/files/3IkP3GM6UBEPGBFhziRj)

3\. Click **Save** at the bottom of the page to save your template or click **Cancel** to discard the draft.

{% hint style="info" %}
**Note**: To create multiple email templates, repeat steps 1-4 as many times as needed.
{% endhint %}

### **Testing the template**

1. Go to **Email Templates** under **OUTGOING EMAILS**.
2. Click the three dots next to the name of the template and choose **Test**.

![](/files/H4ycUQez4sha4OgreYkI)

Read more [here](/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/email-templates.md#emailtemplates-testtemplates).

### Associating the template with your projects and/or issue types

1\. Go to **OUTGOING EMAILS** --> **Contexts**.

2\. Click the **Add** button. The following fields need to be filled:

| Attribute name              | Description                                                                                                                                                                                                                                                                                                    |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Project**                 | Select the project you want to apply the context settings to. Leave the field empty to apply this context for all projects.                                                                                                                                                                                    |
| **Issue Type**              | Select the issue type you want to apply the context settings to. Leave the field empty to apply this context for all issue types.                                                                                                                                                                              |
| **Template**                | Select a default template for this context to use (e.g. the one you customized above). This template will be used when sending emails using the **Email button**.                                                                                                                                              |
| **External Watchers Field** | Add external recipients as watchers to the issue.                                                                                                                                                                                                                                                              |
| **Sender Name Pattern**     | <p>Enter a name that appears in the emails as the sender. If left empty, JETI will use JIRA's default settings.<br>Specify (in <a href="https://velocity.apache.org/engine/1.7/user-guide.html">Velocity markup syntax</a>) how to format the sender's name in outgoing emails.</p>                            |
| **From Email Address**      | <p>Enter the email address you want to use as the "from address" in the emails. If left empty, JETI will use the default settings.</p><p>Specify (in <a href="https://velocity.apache.org/engine/1.7/user-guide.html">Velocity markup syntax</a>) how to format the From Email Address in outgoing emails.</p> |

{% hint style="info" %}
**Note**: To add multiple contexts, repeat step 2 as many times as needed.
{% endhint %}

Read more here:

[Contexts](/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/outgoing-emails/contexts.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/faq/tutorials/customizing-the-email-template-used-with-manual-emails.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
