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.

Before you begin

This tutorial requires the following prerequisites to be met:

The Email This Issue add-on is installed in Jira. Read more here.
A license key is saved in Jira.
You have an SMTP server configured in Jira. Read more here.

Note: You must be a Jira administrator to be able to perform the following settings.

Objectives

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

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

Testing the template

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

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	Enter a name that appears in the emails as the sender. If left empty, JETI will use JIRA's default settings. Specify (in Velocity markup syntax) how to format the sender's name in outgoing emails.
From Email Address	Enter the email address you want to use as the "from address" in the emails. If left empty, JETI will use the default settings. Specify (in Velocity markup syntax) how to format the From Email Address in outgoing emails.

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

Enter a name that appears in the emails as the sender. If left empty, JETI will use JIRA's default settings. Specify (in Velocity markup syntax) how to format the sender's name in outgoing emails.

From Email Address

Enter the email address you want to use as the "from address" in the emails. If left empty, JETI will use the default settings.

Specify (in Velocity markup syntax) how to format the From Email Address in outgoing emails.

Note: To add multiple contexts, repeat step 2 as many times as needed.