HTML tags in Jira notifications sent by Jira Data Center versions that support uploading templates zip

Please note: this article is for Jira Data Center version 8.20.0 or later. It covers both standard and batching email notifications.

Why do I see HTML tags in Jira email notifications?

Jira uses a diff renderer to highlight changes made by a user with a green and red background. This diff renderer cannot display changes in an HTML document and forces the plain text format.

Solution

To correctly display email notifications containing JEditor-enabled field updates, Jira needs modified email templates. Here's how to replace the default Jira email templates with the modified templates:

1. For Jira 8.20+, download templates-jeditor-jira-8.zip
2. For Jira 9.4+, download templates-jeditor-jira-9.zip
3. For Jira 10+, download templates-jeditor-jira-10.zip (see additional info below)
4. Navigate to Jira administration > System > Mail > Email templates
5. Click Upload .zip and select the downloaded templates-jeditor-jira-v.zip file
6. After uploading, Jira should report that templates have been uploaded successfully. You need to wait around 5 minutes for Jira to apply the changes.

Notes:

• You don't need to restart Jira nodes after uploading the templates
• Modified templates survive Jira restarts
• Modified templates are stored in the shared Jira home directory
• You don't need to re-upload these templates when you upgrade JEditor

Additional information about uploading templates in Jira 10

There's a bug in Jira 10 that prevents uploaded templates from functioning properly. 
Try using the workaround from this bug report: https://jira.atlassian.com/browse/JRASERVER-78661. 
If the workaround doesn't resolve the issue and the error persists in atlassian-jira.log, create a support ticket, and we'll assist with the manual installation of the templates.