How to create a custom mail template in Jira Data Center

Still need help?

The Atlassian Community is here for you.

Ask the community

This page is for Jira Data Center

If you’re using Jira Server, please consult the 2024-01-23_08-51-45_Customizing email content in Jira Server.

This article is an extension of Customizing email content for Jira Data Center administration page. If this is your first reading about email content customization or email templates, please go to that page initially.

Customizations to Velocity templates or other Jira files are not included in the scope of Atlassian Support.

Summary

To create a new email template in Jira Data Center, to be used along with specific Jira event, there are steps to be followed, listed below.

Attention! This article applies to version 8.14 or later. Previous versions of Jira use a diferent format to download/upload templates, the applied changes can be read on Jira 8.14 release notes (Email templates made better)

Steps 

  1. Download the email templates from Administration > System > Email templates
  2. Using the structure from the downloaded Zip file, create new template.vm files in the htmltext , and subject directories, based on the existing files in those directories
  3. Zip the templates folder and upload the zipped email templates on Administration > System > Email templates (note it will overwrite the information in <Jira-shared-home>/data/templates/email).
  4. Edit the <Jira app folder>/atlassian-jira/WEB-INF/classes/email-template-id-mappings.xml adding the created templates to make them valid choices for when you are adding a new event.
  5. Restart Jira


Example

  1. Download the email templates from Administration > System > Email templates
  2. Using the structure from the downloaded Zip file, create new template.vm files in the htmltext , and subject directories, based on the existing files in those directories
  3. Zip the templates folder and upload the zipped email templates on Administration > System > Email templates (note it will overwrite the information in <Jira-shared-home>/data/templates/email).

  4. Edit the <Jira app folder>/atlassian-jira/WEB-INF/classes/email-template-id-mappings.xml adding the created templates to make them valid choices for when you are adding a new event.
  5. Restart Jira
  6. Validation





Last modified on Feb 28, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.