Templates: Separate issue notifications and other events

Still need help?

The Atlassian Community is here for you.

Ask the community

The archive that you downloaded from Jira contains email templates from all available configuration options. It’s easy to get lost in the files and their dependencies, especially that not all of them apply to your configuration. Use this page to understand the templates and the notifications they control.

This page is for separate issue notifications in Jira

This page is for separate issue notifications (batched issue updates are disabled). If you’re using batched issue notifications, see Batched issue notifications.

Not sure which notifications you’re using?

Definitions

We’re referring to templates and includes around this page. Since all of them are Velocity templates, here’s the best way to understand them:

  • Templates: Main templates used for notifications. Usually, a template like that is a notification that you’re getting. You’d modify them if you’d like to customize the looks of a specific notification rather than an item that is shared with all notifications, like footer.

  • Includes: Includes aren’t used on their own, but are always referenced in main templates. You’d modify them if you’d like to customize the looks of an item shared with all notifications rather than the notification itself. For example, changing footers or headers.

Issue notifications

These templates control notifications about issues.

Directory: templates/email/html

Issue lifecycle

TemplateDescriptionIncludes
issuecreated.vm

Issue was created.

  • Patterns: issue-title.vm

  • Fields: issuetype.vm

  • Fields: affectsversions.vm

  • Fields: assignee.vm

  • Fields: attachments.vm

  • Fields: components.vm

  • Fields: createddate.vm

  • Fields: duedate.vm

  • Fields: environment.vm

  • Fields: fixversions.vm

  • Fields: labels.vm

  • Fields: priority.vm

  • Fields: reporter.vm

  • Fields: securitylevel.vm

  • Fields: timetracking.vm

  • Patterns: text-paragraph.vm

  • Patterns: comment-action.vm

  • Includes: footer.vm

issuedeleted.vm

Issue was deleted.

  • Patterns: issue-title.vm

  • Includes: footer.vm

issueassigned.vm

Issue was assigned to someone.

  • Patterns: comment-top.vm

  • Patterns: issue-title.vm

  • Fields: changelog.vm

  • Patterns: comment-action.vm

  • Includes: footer.vm

issuresolved.vm

Issue was resolved.

  • Patterns: comment-top.vm

  • Patterns: issue-title.vm

  • Patterns: comment-action.vm

  • Includes: footer.vm

  • Fields: changelog.vm

issueclosed.vm

Issue was closed.

  • Patterns: comment-top.vm

  • Patterns: issue-title.vm

  • Patterns: comment-action.vm

  • Fields: changelog.vm

  • Includes: footer.vm

issuereopened.vm

Issue was reopened.

-

issueupdated.vm

Issue was updated.

  • Patterns: issue-title.vm

  • Patterns: comment-top.vm

  • Patterns: comment-action.vm

  • Includes: footer.vm

  • Includes: changelog-issue-description.vm

  • Fields: changelog.vm

issuemoved.vm

Issue was moved to a different project, issue type, etc.

  • Patterns: text-top.vm

  • Patterns: issue-title.vm

  • Patterns: comment-action.vm

  • Includes: footer.vm

issuegenericevent.vm

Issue generic event

  • Patterns: comment-top.vm

  • Patterns: issue-title.vm

  • Patterns: comment-action.vm

  • Includes: changelog-issue-description.vm

  • Includes: footer.vm

  • Fields: changelog.vm

Issue collaboration

TemplateDescriptionIncludes
issuecommented.vm

Issue was commented on.

  • Patterns: comment-title.vm

  • Patterns: comment-action.vm

  • Includes: set-issue-details.context.vm

  • Includes: footer.vm

issuecommentedited.vm

Issue comment was edited.

  • Patterns: comment-title.vm

  • Patterns: comment-top.vm

  • Patterns: comment-action.vm

  • Includes: set-issue-details-context.vm

  • Includes: footer.vm

issuementioned.vm

Someone mentioned you in an issue.

  • Patterns: comment-title.vm

  • Patterns: comment-top.vm

  • Patterns: comment-action.vm

  • Includes: set-issue-details-context.vm

  • Includes: footer.vm

issuenotify.vm


  • Patterns: comment-top.vm

  • Patterns: issue-title.vm

  • Patterns: comment-action.vm

  • Includes: footer.vm

  • Fields: changelog.vm

Issue archiving

TemplateDescriptionIncludes
issuearchived.vm

Issue was archived.

  • Patterns: issue-title.vm

  • Includes: footer.vm

issuerestored.vm

Issue was restored from the archive.

  • Patterns: issue-title.vm

  • Includes: footer.vm

Issue work logging

TemplateDescriptionIncludes
issueworklogdeleted.vm

Issue work log was deleted.

-

issueworklogged.vm

Work was logged in an issue.

-

issueworklogupdated.vm

Issue work log was updated.

-

issueworkstarted.vm

Work started on issue.

  • Patterns: comment-top.vm

  • Patterns: comment-action.vm

  • Fields: changelog.vm

  • Includes: set-issue-details-context.vm

  • Includes: footer.vm

issueworkstopped.vm

Work stopped.

  • Patterns: comment-top.vm

  • Patterns: comment-action.vm

  • Includes: set-issue-details-context.vm

  • Includes: footer.vm

  • Fields: changelog.vm

Other notifications

These notifications control other events like sharing filters or user management.

Share templates

Directory: templates/email/html

TemplateDescriptionIncludes
shareissue.vm

Someone is sharing an issue with you.

  • Includes: header.vm

  • Includes: footer.vm

  • Patterns: involvedUsers.vm

  • Patterns: comment-top.vm

  • Patterns: issue-title.vm

  • Templates: mobileSingleColumnStyle.vm

sharejqlsearch.vm

Someone is sharing a JQL search with you.

  • Includes: header.vm

  • Includes: footer.vm

  • Patterns: involvedUsers.vm

  • Patterns: comment-top.vm

  • Patterns: page-title.vm

  • Templates: mobileSingleColumnStyle.vm

sharesavedsearch.vm

Someone is sharing a saved search (filter) with you.

  • Includes: footer.vm

  • Patterns: involvedUsers.vm

  • Patterns: comment-top.vm

  • Patterns: page-title.vm

  • Templates: mobileSingleColumnStyle.vm

Contact admin templates

Directory: templates/email/html

TemplateDescriptionIncludes
contactadministrator.vm

contactadministrator.vm

Notification that Jira admin is getting after someone tries to contact them over the Contact Admin form.

  • Includes: header.vm

  • Includes: footer.vm

  • Patterns: page-title.vm

  • Patterns: text-paragraph.vm

emailfromadmin.vm

emailfromadmin.vm

Emails sent to users directly from the Jira admin.

  • Includes: footer.vm

  • Patterns: page-title.vm

  • Patterns: text-paragraph.vm

User management templates

Directory: templates/email/html

TemplateDescriptionIncludes
usercreated.vm

New user was created. Notification for Jira admins.

  • Includes: header.vm

  • Includes: footer.vm

  • Includes: userdetails.vm

  • Patterns: button-action.vm

  • Patterns: page-title.vm

  • Patterns: text-paragraph.vm

usercreated-nopassword.vm

New user was created in an external directory, and their password can’t be changed. Notification for Jira admins.

  • Includes: header.vm

  • Includes: footer.vm

  • Includes: userdetails.vm

  • Patterns: page-title.vm

  • Patterns: text-paragraph.vm

usersignup.vm

Notification users receive after signing up to Jira.

  • Includes: header.vm

  • Includes: footer.vm

  • Includes: userdetails.vm

forgotusername.vm

Notification users receive if they forget their usernames.

  • Includes: header.vm

  • Includes: footer.vm

forgotpassword.vm

Notification users receive if they forget their password.

  • Includes: header.vm

  • Includes: footer.vm

  • Includes: userdetails.vm

Includes

Includes

List of includes referenced in main templates.

Directory: templates/email/html/includes

View Includes...
TemplateDescriptionIncluded in
emailconstants.vm

Fonts and colors of headers, headings, and links.

  • macros.vm

  • footer.vm

  • header.vm

footer.vm

Email footer.

Share:

  • shareissue.vm

  • sharejqlsearch.vm

  • sharesavedsearch.vm

Contact admin:

  • contactadministrator.vm

  • emailfromadmin.vm

User management:

  • usercreated.vm

  • usercreated-nopassword.vm

  • usersignup.vm

  • forgotusername.vm

  • forgotpassword.vm

header.vm

Email header.

Share:

  • shareissue.vm

  • sharejqlsearch.vm

Contact admin:

  • contactadministrator.vm

User management:

  • usercreated.vm

  • usercreated-nopassword.vm

  • usersignup.vm

  • forgotusername.vm

  • forgotpassword.vm

userdetails.vm

Details of a user: username, email address, display name.

User management:

  • usercreated.vm

  • usercreated-nopassword.vm

  • usersignup.vm

  • forgotpassword.vm

changelog-issue-description.vm

Shows the old and updated issue description.

  • issueupdated.vm

  • issuegenericevent.vm

Issue notifications: Fields

Issue fields referenced in main templates to display data from specific fields. Applies only to issue notification templates.

Directory: templates/email/html/fields

Other notifications: Patterns

It’s unlikely that you’ll need to edit any of the pattern templates. They contain reusable components that are common for the Jira UI, like action buttons, titles, or text paragraphs. If you wanted to check them out anyway, you can find them in templates/email/html/patterns.

Directory: templates/email/html/patterns

Last modified on Mar 22, 2021

Was this helpful?

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