Apps documentation
Dynamic Forms for Jira
Dynamic Forms for Jira
Version 7.x
Version 5.x and older
Release notes
Last updated Jan 13, 2021

Email notifications

Set up email notifications containing Bundled Fields data

The dedicated custom field for Bundled Fields can be included in email notifications that Jira sends to you after creating or modifying an issue that contains that custom field. However, Bundled Fields configuration slightly differs from the one provided by Jira. To avoid problems with displaying Bundled Fields incorrectly, follow the instructions below.

Batching email notifications (default in Jira 8.x)

In order to get a formatted custom field value in an email notification sent upon issue creation, mark the Bundled Fields custom field as renderable (for example, extend the RenderableTextCFType class).

This will enable choosing a renderer for the custom field in Jira fields’ configuration.

Changing the renderer

By default, the custom field’s contents are displayed in a .json format – which might be hard to read, especially when a lot of data is involved.

Here is how to increase the readability of that information:


  1. Go to Jira Administration > Issues.
  2. Open Field configuration.
  3. Select the Field Configuration that contains your custom field.
  4. Click Configure.
  5. Navigate to the chosen Bundled Fields’ custom field and click Renderers.
  6. Select [Dynamic Forms] Bundled Fields Renderer.
  7. Click Update to save the change.
Dynamic Forms for Jira - Bundled Fields Email Notifications: Change the Renderer
Dynamic Forms for Jira - Bundled Fields Email Notifications: Change the Renderer

Bundled Fields Renderer will only change the format of data being displayed in email notifications and in other forms of data exports. It won’t affect the way Bundled Fields are displayed in Jira, or the values associated with those fields. It works for standard Jira notifications.

Standard notifications (Jira 7.x and older)


Before you start, create a proper email template (HTML format) and a .vm file according to these instructions.

Emails in text format

In a standard custom field’s configuration, you need to modify the issuecreated.vm template with the following code that generates a formatted Bundled Fields value:


#set ($bundledField = $customFieldManager.getCustomFieldObject("customfield_13700"))
#set ($bundledFieldType = $bundledField.getCustomFieldType())
#set ($bundledFieldValue = $issue.getCustomFieldValue($bundledField))
#set ($bundledFieldChangelogValue = $bundledFieldType.getChangelogString($bundledField, $bundledFieldValue))
#if ($bundledFieldValue)
    $stringUtils.leftPad($, $padSize): $bundledFieldChangelogValue

Emails in HTML format

In order to generate HTML-formatted emails, add the formattedbundledfields.vm template to issuecreated.vm


#set ($customfield = $customFieldManager.getCustomFieldObject("customfield_13700"))
#set ($customfieldType = $customfield.getCustomFieldType())
#set ($customfieldValue = $issue.getCustomFieldValue($customfield))
#set ($changelogValue = $customfieldType.getChangelogString($customfield, $customfieldValue))
#set ($encodedChangelogValue =  $textutils.htmlEncode($changelogValue, false))
#set ($changelogValueHtml = $encodedChangelogValue.replaceAll( "\n","<br/>"))
	    <td class="has-icon">


<table class="keyvalue-table">

Make sure to use the proper ID of your target Bundled Field to getCustomFieldObject parameter (presented Bundled Field’s ID is only exemplary).


When the file configuration is ready, remember to restart your Jira.

Need help?

If you can’t find the answer you need in our documentation, raise a support request.