Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

Image RemovedImage Added

Step 2. To manage custom templates click Templates tab on the left side menu.

Image RemovedImage Added

Step 3. Click Add new template button.

You will be redirected to the “Add template” page.

Image RemovedImage Added

Step 4. Create custom email templates by filling the fields.

Image RemovedImage Added

You can use our prompts and descriptions:

  1. Name - a required field, name of the template - it must be unique.

  2. Example template - you can choose Jira’s default template as a basis and change it. HTML

  3. Context parameters - you can use it as a cheat sheet with the issue parameters

  4. HTML Body Template - a required field, template content for HTML format email.

  5. Text Body Template - a required field, template content for Text format email.

  6. Save - saves the template and redirects you to the page with a list of templates.

  7. 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