Actions
Clone issue
- Use smart values here: Yes
- Available in Server Lite: No
Cloning an issue lets you quickly create a duplicate of an issue within the same project or a project of your choosing. This can also be used as part of a workaround for moving issues between projects.
Due to a lack of an available API for cloning issues, this action creates a new issue and copies across all of the fields that it can. Its status is then set to the first step of the corresponding workflow, and any resolutions from the original issue are cleared. However, as it is not a true clone, the cloned issue isn't linked to the original issue.
You can also set any supported fields to a value of your choosing that will override any copied values (see Edit additional fields for help on using additional fields in the advanced section).
Limitations
Due to API limitations in Jira, this action does not clone issue links and comments.
Comment on issue
- Use smart values here: Yes
- Available in Server Lite: Yes
Use this to add a comment to an issue. You can use smart values to reference issue fields to personalize the message along with setting the visibility of the comment.
Create issue
- Use smart values here: Yes
- Available in Server Lite: No
- Rule actor permission: Browse projects and create issues
Use this action to create an issue of any type in any project. You can select any number of fields and set their values (see Edit additional fields for help on using the additional fields in the More Options section). If you are working with sub tasks then you may find our blog post, creating sub-tasks with required fields, helpful.
Tip
- Care needs to be taken with global rules that use the same project as trigger issue options as we do not know what the project type is until the rule runs. All issue types are available which means that you could choose an issue type that does not exist in a project.
- Service Desk specific fields such as 'Request type', 'Request participants' or 'Organization' are only available in Jira 7.3+ and Service Desk 3.3+.
Create sub-tasks
- Use smart values here: Yes
- Available in Server Lite: No
A quick way to add a number of sub tasks to an issue. This action only supports specifying the summary.
Setting fields
Choosing Add fields will remove the individual sub task from the action and add a new Create Issue action where you can specify fields.
Delete issue
- Use smart values here: No
- Available in Server Lite: Yes
Deletes the current issue that is in context. This is a great way to remove unwanted issues from Jira, such as in automating moving issues between projects.
Edit issue
- Use smart values here: Yes
- Available in Server Lite: No
Using this action you can easily edit most fields of the current issue, simply choose the field to set and add the value for it. Some of the values can be dynamic. You can also use the flexibility of additional fields in More options for those more complicated situations.
Tip
Service Desk specific fields such as 'Request type', 'Request participants' or 'Organization' are only available in Jira 7.3+ and Service Desk 3.3+.
Link issues
- Use smart values here: Yes
- Available in Server Lite: No
Using this action you can easily link issues, simply select the link type and the issue to link. You can use the options in the issue drop down, enter an issue key into the drop down for a specific issue or enter a smart value into the drop down for those advanced use cases. To read more on advanced use cases, check out our blog post Automatically linking issues.
Log work
- Use smart values here: Yes
- Available in Server Lite: No
With this action you can log time against an issue. You can use date and time smart values to help you dynamically set the date started and text smart values to customise the description.
Manage watchers
- Use smart values here: Yes
- Available in Server Lite: No
Sometimes you just want to make sure that certain people get notified when an issue is updated. With this action you can add or remove watchers as necessary. You can also specify users to add or remove by typing {{smart values}}
directly into the fields.
Transition issue
- Use smart values here: Yes
- Available in Server Lite: Yes
This action transitions an issue through a workflow. You can also select fields to update as part of the transition, for example:
- Copy from issue - use this when you need to copy the status from a related issue or an issue on a branch rule
- Copy from parent - for use with sub-tasks, sources the status from their parent
- Copy from Epic - sources the status from the issue's associated epic.
- Copy from Trigger issue - sources the status from the issue that triggered this rule, most useful on branches
- Same status (loop) - for use when a transition exists from the current status back to itself, typically used in conjunction with a screen to gather more data from users (e.g. an "Escalate" transition)
Send email
- Use smart values here: Yes
- Available in Server Lite: No
This action allows you to send an email. All of the fields support customisation via smart values.
The default ‘from’ address in emails is Jira’s default email.
If you configure this rule to send emails to a group, it will only send it to 100 users from the group, omitting the rest. That's a limitation, and you'll need to work around it by creating smaller groups.
Tip
Service Desk specific recipients such as 'Pending approvers' are only available in Jira 7.3+ and Service Desk 3.3+.
Send Microsoft Teams message
- Use smart values here: Yes
- Available in Server Lite: No
Notify a team when the rule is run. You can personalise the message using the provided fields. Refer to how to integrate Microsoft Teams for detailed instructions.
Send Slack message
- Use smart values here: Yes
- Available in Server Lite: No
Notify a team or an individual when the rule is run. You can personalise the message using the provided fields. Refer to how to integrate Slack for detailed instructions.
Send Twilio (SMS) message
- Use smart values here: Yes
- Available in Server Lite: No
A lot of service teams rely on SMS for on-call scenarios. With this action you can send a notification using the Twilio service.
Send outgoing web request
Currently, you can't send an outgoing web request from Jira Server to Jira Cloud. Follow this bug for updates:
JIRAAUTOSERVER-25 - Getting issue details... STATUS
- Use smart values here: Yes
- Available in Server Lite: No
Quite often you need to integrate with other systems. This action allows you send an outgoing web request to notify another system when the rule is run, and optionally return response data that can then be used in a subsequent action. It is an extemely powerful action. Learn more about it in this blog.
Add Service Desk customer
- Use smart values here: Yes
- Available in Server Lite: No
- Minimum Jira version: Jira 7.5+ and Service Desk 3.3+
Add new customers to your Jira Service Desk project with this handy little action. You can use smart values in all fields and add the customer to one of your existing organizations.
Check out this great blog post Create customers and add Jira Service Desk requests!
Create Service Desk request
- Use smart values here: Yes
- Available in Server Lite: No
- Minimum Jira version: Service Desk 3.3+
Creates a new Jira Service Desk request. Just like the above Create issue action, this allows you to configure any field available using smart values.
Create version
- Use smart values here: Yes
- Available in Server Lite: No
This creates a new version you can assign issues to. If a version with the same name already exists, no new version is created.
Release version
- Use smart values here: Yes
- Available in Server Lite: No
Use this to release a version. By default, this releases the next unreleased version of a project with the existing release date. The "next version" is determined by the order you set in the "Releases" tab on your software project. You can pick a specific version to release and use a smart value to set dynamic names.
Delete attachments
- Use smart values here: Yes
- Available in Server Lite: Yes
Use this action to clean up old attachments using regular expression matches based on the attachment filename.
Log action
- Use smart values here: Yes
- Available in Server Lite: Yes
This action logs something to the audit log. This is a great way to try out smart values and see what they return, and a great way to debug your rules.
Re-fetch issue data
- Use smart values here: No
- Available in Server Lite: Yes
This action refreshes smart values with the latest field values. By default the {{issue}}
reference is not updated during rule execution, and therefore contains the same values as when the rule originally triggered.
Set entity property
- Use smart values here: Yes
- Available in Server Lite: No
Use this to set hidden 'entity' properties on issues, projects or users related to the trigger issue of the rule execution. These properties can then be used by apps for some functions. Entity properties allow plugins to add key/value stores to Jira entities, such as issues or projects. These values can be indexed by Jira and queried via REST API or JQL.
Publish event
- Use smart values here: Yes
- Available in Server Lite: Yes
Use this to publish Jira events (system or custom) that other add-ons and integrations can listen for.
Third party actions
Automation for Jira in server allows extensions contributed by other app vendors in the Atlassian Marketplace that contribute automation actions directly in our UI. For details on how to contribute these actions see our developer guide.
If you require support for the following actions, please contact the action's vendor.
The following table contains 3rd party actions you can automate with Automation for Jira. Check our developer guide for details on how to contribute to these actions, and contact the action's vendor if you require support for these actions.
Please be aware that third party apps can cause problems with event handling, serialising issues, calculated custom fields, performance issues, etc. Some of the add-ons we've seen cause issues are:
If you experience issues around performance, or rules not running correctly, and you have any of these add-ons installed, try disabling them to see if the problem goes away.
Available in Lite
These third party apps have been whitelisted in Lite. For the remaining apps, you'll need to the Pro version of Automation for Jira.
- PDF Automation Plugin for Jira by Midori
- Excel Automation Plugin for Jira by Midori
- Elements Connect by Elements
- Simple Task lists by Top Shelf Solutions