Configure resolutions in a Jira workflow

When configuring your teams' workflows, you might need to add new Done statuses.

For each new Done status, or other statuses considered end states (like, Won't do or Cancelled), we recommend making sure that the Resolution field is automatically set whenever work transitions to it. Include specific custom resolutions, if needed. Read more about resolutions in Jira

There are two ways to do this. You can either:

• Automatically set the resolution when work moves to Done, or

• Prompt people to choose a resolution when they move work to Done.

Remember that Jira automatically sets the resolved date when the Resolution field transitions from 'Unresolved' to a value, so ensure this step is configured in workflows to maintain accurate reporting.

Automatically set the resolution

To automatically mark work as resolved:

1. Go to Jira settings (), then select Work items and then Workflows.

2. Find the workflow you want to edit. Under Actions, select More actions (), then Edit.

3. Select a transition connecting to a Done status (an arrow leading to any Done status), or away from a resolved status.

4. In the details panel next to Rules, select Add ().

5. From the Perform action, select Update an issue field, then Select.

6. From the Update this field dropdown, select Resolution.

7. From the Resolution dropdown, select the resolution that should automatically be set when work moves to this Done status. Then, select Add.

8. Select Update workflow to save the changes to the workflow.

Prompt people to choose a resolution

To let people choose a resolution each time:

1. Go to Jira settings (), then select Work items and then Workflows.

2. Find the workflow you want to edit. Under Actions, select More actions (), then Edit.

3. Select a transition connecting to a Done status (an arrow leading to any Done status), or away from a resolved status.

4. In the details panel next to Rules, select Add ().

5. From the Validate details rule, select Show a screen, then Select.

6. Select the screen that will display when the user moves work to Done. Make sure the screen has the Resolution field.

   • Jira comes with a Resolve work item screen for moving work to Done, but you can use your own custom screen for this, too. If you’re using custom screens, make sure that the Resolution field is only set when moving work to a Done status. More: Manage existing work item screens

7. Return to the workflow and select Publish draft.

You can also exclude specific resolutions from displaying. To do this, select Properties and then:

1. For Property Key, enter jira.field.resolution.exclude.

2. For Property Value, enter the ID of each resolution you want to exclude. Multiple IDs should be separated by a comma with no space (e.g. 10000,10100,10200)

You can find each resolution ID by going to Jira settings. Find Work items, then Resolutions, and then Edit. You’ll find the ID at the end of the URL.