How to create custom email templates?
Jira Administrator can create own email templates for their specific business purposes. Mail Me users will be able to use them when sending emails.
To create custom email templates, please follow the next steps:
Step 1. Go to the Jira Administration tab and select Manage apps section.
Step 2. To manage custom templates click Templates tab on the left side menu.
Step 3. Click Add new template button.
You will be redirected to the “Add template” page.
Step 4. Create custom email templates by filling the fields.
You can use our prompts and descriptions:
Name - a required field, name of the template - it must be unique.
Example template - you can choose Jira’s default template as a basis and change it.
Context parameters - you can use it as a cheat sheet with the issue parameters
HTML Body Template - a required field, template content for HTML format email.
Text Body Template - a required field, template content for Text format email.
Save - saves the template and redirects you to the page with a list of templates.
Cancel - allows you to return to the previous page with a list of templates without saving.
Context parameters
In templates we use Velocity Template Language (VTL) to incorporate dynamic content in the email. You can use the following context parameters:
$issue | com.atlassian.jira.issue.IssueImpl |
$outlookdate | com.atlassian.jira.web.util.OutlookDate |
$permissionCheck | com.atlassian.jira.web.bean.PermissionCheckBean |
$dateutils | com.atlassian.jira.util.JiraVelocityUtils$DateUtils |
$featureManager | com.atlassian.jira.config.feature.DefaultFeatureManager |
$currentCalendar | com.atlassian.jira.util.JiraVelocityUtils$LazyCalendar |
$soyRenderer | com.atlassian.soy.impl.DefaultSoyTemplateRenderer |
$dateFormatter | com.atlassian.jira.datetime.DateTimeFormatterImpl |
$authcontext | com.atlassian.jira.security.JiraAuthenticationContextImpl |
$rteEnabled | java.lang.Boolean |
$req | com.atlassian.plugin.servlet.PluginHttpRequestWrapper |
$projectManager | com.atlassian.jira.project.CachingProjectManager |
$customFieldManager | com.atlassian.jira.issue.managers.CachingCustomFieldManager |
$prioritySchemeManager | com.atlassian.jira.issue.fields.config.manager.PrioritySchemeManagerImpl |
$jirautils | com.atlassian.jira.util.JiraUtils |
$userformat | com.atlassian.jira.plugin.userformat.DefaultUserFormatManager |
$constantsManager | com.atlassian.jira.config.DefaultConstantsManager |
$mailPluginsHelper | com.atlassian.jira.mail.JiraMailPluginsHelperImpl |
$webResourceManager | com.atlassian.jira.plugin.webresource.JiraWebResourceManagerImpl |
$avatarServiceHelper | com.atlassian.jira.avatar.AvatarServiceHelper |
$jirakeyutils | com.atlassian.jira.util.JiraKeyUtils |
$jiraUserUtils | com.atlassian.jira.user.util.UserUtilImpl |
$userutils | com.atlassian.jira.user.UserUtils |
$build | com.atlassian.jira.util.BuildUtilsInfoImpl |
$textutils | com.opensymphony.util.TextUtils |
$applicationProperties | com.atlassian.jira.config.properties.ApplicationPropertiesImpl |
$avatarService | com.atlassian.jira.avatar.AvatarServiceImpl |
$urlModeAbsolute | com.atlassian.plugin.webresource.UrlMode |
$velocityhelper | com.atlassian.jira.util.JiraVelocityHelper |
$currentMillis | java.lang.Long |
$urlcodec | com.atlassian.jira.util.JiraUrlCodec |
$keyboardShortcutManager | com.atlassian.jira.plugin.keyboardshortcut.CachingKeyboardShortcutManager |
$dateTimeStyle | org.apache.velocity.app.FieldMethodizer |
$webResourceUrlProvider | com.atlassian.jira.plugin.webresource.JiraWebResourceUrlProvider |
$dates | com.atlassian.jira.datetime.DateVelocityUtils |
$dateTimes | com.atlassian.jira.datetime.DateTimeVelocityUtils |
$baseurl | java.lang.String |
$externalLinkUtil | com.atlassian.jira.web.util.ExternalLinkUtilImpl |
$requestContext | com.atlassian.jira.util.velocity.SimpleVelocityRequestContext |
$atl_token | java.lang.String |
$xmlutils | com.atlassian.core.util.XMLUtils |
$issueConstantWebComponent | com.atlassian.jira.web.component.IssueConstantWebComponent |
$cfValueEncoder | com.atlassian.jira.render.SwitchingEncoder |
$map | com.atlassian.core.util.map.EasyMap |