The Send an email post function allows you to easily send an email with custom subject and body, setting recipients by means for fields, custom fields, groups, project roles, or simply fixed email addresses.
You can optionally choose to include all or some of the issue attachments.
You could use this post function to easily email a customized issue report to the assignee, reporter, service desk customer, or any user you can think of.
Configuration
Select the email address the email will be sent from. The following options are available:
- Based on the outgoing email configuration
- Based on the project configuration
- Selected user
- User in field
- Email address in field
Set email manually
When selected, a valid email address* must be entered.
Select how the email will be sent. The following two options are available:
- Default
Personalized
When selected, a dedicated email will be sent out to each recipient. The recipient won't see any other recipients' email addresses.
Choose the priority of the email between High, Default, or Low.
Define and configure the recipients of the email. The following options are available:
- Add field containing users
- Add field containing email addresses
- Add project roles
- Add groups
Set recipients manually
When selected, enter valid email addresses as a comma-separated list.
Define and configure the recipients in CC of the email.
The same options like above are available.
Define and configure the recipients in Bcc of the email.
The same options like above are available.
Enter plain text using the mixed parsing mode and optionally use field codes to insert field values.
Select the format of the email, either Text or HTML.
Enter plain text using the mixed parsing mode and optionally use field codes to insert field values.
- You can try your expression by clicking on the run button on the top right of the expression box.
- Expression parser functions can also be used by writing them within three curly braces e.g. {{{subtasks()}}}.
Select the files to attach to the email. The following options are available:
- None
All issue attachments
All transition attachments
When one of the last two options is selected, you can filter the files by size, type, and name. Files that do not match the filters will be skipped.
- Add to recipients as watchers - Add to recipients as watchers of the current issue, if those are valid Jira users.
- Add Cc recipients as watchers - Add Cc recipients as watchers of the current issue, is those are valid Jira users.
- Temporary store email information - Store email information in the temporary fields 1-5.
- Temporary text field 1: From
- Temporary text field 2: To
- Temporary text field 3: Cc
- Temporary text field 4: Email subject
- Temporary text field 5: Email body (text format)
The result of the logical expression must return a boolean value of either:
true
→ the post function will be executedfalse
→ the post function will not be executed
Using the conditional operator, even complex or multi-layered conditions can be constructed.
Make sure to learn more about defining logical expressions and browse through the various examples here: Logical mode
Configuration
Select the email address the email will be sent from. The following options are available:
Option | Description |
---|---|
Based on the outgoing mail configuration | The default user specified in you outgoing mail server configuration will be used. |
Based on the project configuration | The user specified in your project notifications. |
Selected user | Select a specific Jira user. |
User in field | Select the field containing the user. Text fields must return a user name. |
Email address in field | Select the field containing the email address. |
Set email manually | Enter a valid email address. |
Select how the email will be sent. The following two options are available:
Option | Description |
---|---|
Default | Choose this option if all recipient should receive the same content. |
Personalized | When selected, a dedicated email will be sent out to each recipient. The list of all recipients will be undisclosed. |
Select the priority of the outgoing email. The available options are High, Default, or Low.
Define and configure the recipients of the email. The following options are available:
Option | Description |
---|---|
Add field containing users | Select one or multiple fields containing users or groups. Text fields or Temporary text fields must return a user name or a comma separated list of user names. |
Add field containing email addresses | Select one or multiple fields containing a single email address or a comma separated list of email addresses. |
Add project roles | Select one or multiple project roles. The email will be sent out to all members that have access to the issue. |
Add groups | Select one or multiple groups. The email will be sent out to all members that have access to the issue. |
Set recipients manually | Enter one or multiple email addresses as a comma separated list. |
Select additional CC recipients.
The options you can choose from are identical to the options provided above.
Select additional BCC recipients.
The options you can choose from are identical to the options provided above.
Subject
Enter plain text using the mixed parsing mode and optionally use field codes to insert field values.
Email format
Select the format of the email, either Text or HTML.
Enter plain text using the mixed parsing mode and optionally use field codes to insert field values.
- You can try your expression by clicking on the run button on the top right of the expression box.
- Expression parser functions can also be used by writing them within three curly braces e.g. {{{subtasks()}}}.
Select the files to attach to the email. The following options are available:
- None
All issue attachments
All transition attachments
When one of the last two options is selected, you can filter the files by size, type, and name. Files that do not match the filters will be skipped.
- Add to recipients as watchers - Add to recipients as watchers of the current issue, if those are valid Jira users.
- Add Cc recipients as watchers - Add Cc recipients as watchers of the current issue, is those are valid Jira users.
- Temporary store email information - Store email information in the temporary fields 1-5.
- Temporary text field 1: From
- Temporary text field 2: To
- Temporary text field 3: Cc
- Temporary text field 4: Email subject
- Temporary text field 5: Email body (text format)
The result of the logical expression must return a boolean value of either:
true
→ the post function will be executedfalse
→ the post function will not be executed
Using the conditional operator, even complex or multi-layered conditions can be constructed.
Make sure to learn more about defining logical expressions and browse through the various examples here: Logical mode
Use cases and examples
Title |
---|
No content found. |
If you still have questions, feel free to refer to our support team.