HTML tags in Jira notifications (regular email notifications)

Please note: this article is about regular Jira Server email notifications. For Jira Data Center notifications, see HTML tags in Jira notifications sent by Jira Data Center 8.20.0+. If you have HTML tags in batching email notifications, see HTML tags in Jira notifications (batching email notifications).

Notification format

Configure your Jira to use HTML as the default format for emails to receive HTML notifications. If all your notifications come with visible HTML tags then your default email format is plain text.

Jira system administrators can specify the default email format under Jira administration > System > Default User Preferences (shortcut: gg > email format).

Why do I still see HTML tags in Jira notifications after I switched to the HTML format?

Some notifications (e.g., Issue Updated and Comment Updated) will keep coming with visible HTML tags. 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

Jira 7

1. Download changelog.vm and replace the original changelog.vm under <Jira-install-directory>\atlassian-jira\WEB-INF\classes\templates\email\html\includes\fields\
2. Download changelog-issue-description.vm and replace the original changelog-issue-description.vm under <Jira-install-directory>\atlassian-jira\WEB-INF\classes\templates\email\html\includes
3. Download set-issue-details-context.vm and replace the original set-issue-details-context.vm under <Jira-install-directory>\atlassian-jira\WEB-INF\classes\templates\email\html\includes
4. Download issuecommentedited.vm and replace the original issuecommentedited.vm under <Jira-install-directory>\atlassian-jira\WEB-INF\classes\templates\email\html\
5. Download worklog-top.vm and replace the original worklog-top.vm under <Jira-install-directory>\atlassian-jira\WEB-INF\classes\templates\email\html\includes\patterns
6. Download worklogchanges.vm and replace the original worklogchanges.vm under <Jira-install-directory>\atlassian-jira\WEB-INF\classes\templates\email\html\includes\fields
7. Restart Jira to reload templates

Make sure that Jira has read access to these new files.

Jira 8.0.0 - 8.10.1

1. Download html.zip
2. Extract the html folder
3. Stop Jira
4. Replace <Jira-install-directory>\atlassian-jira\WEB-INF\classes\templates\email\html with the downloaded html folder
5. Start Jira

Make sure that Jira has read access to the new folder.

Jira 8.11.0 - 8.16.2

1. Download html8110-8162.zip
2. Extract the html folder
3. Stop Jira
4. Replace <Jira-install-directory>\atlassian-jira\WEB-INF\classes\templates\email\html with the downloaded html folder
5. Start Jira

Make sure that Jira has read access to the new folder.

Important:
Minor changes in templates may vary across Jira versions. Please contact our support team for the best templates that suit your Jira version.