Editing statuses

You need administrator rights in Jira to perform the tasks on this page.

Once you have gone to the Custom fields page (see Configuring the Checklist custom field), click Edit Statuses to configure the statuses that can be assigned to checklist items:

If you see a message here that says “Statuses are disabled”, you will need to enable the Statuses setting to allow users to assign statuses to checklist items (for details, see Editing parameters).

The following page will appear:

Statuses are added to checklist items for information purposes, as they are an easy way to track the progress of tasks within a project.

Creating statuses

The default N/A, In Progress, and Blocked statuses will already be displayed in the status editor, but you can also add your own custom statuses to the editor. To do so:

Click Add Status.
Referring to the table below, fill out each field and drop-down. The Preview column will automatically update with your changes.
Click Save.

Parameter	Description

Parameter	Description
Name	The name that will be displayed on the status tag.
ID	Any unique ID (cannot contain spaces or be set to `none`). The ID ensures that future changes to the statuses are applied to the correct checklist items. If the ID is changed, any items that had that status will show as having no status in the checklist.
Style	The appearance of the status. Styles are applied as per Jira's UI library, and the colors may change in the future if Jira updates them. Existing styles: DEFAULT, SuCCESS, ERROR, CURRENT, COMPLETE, MOVED
Completion Behavior	The behavior of an item’s checkbox when a status is set for that checklist item. Keep: The checkbox remains as is. Complete: The checkbox is marked as complete. Incomplete: The checkbox is marked as incomplete.
Status Behavior	The behavior of the status when an item’s checkbox is checked. Keep: The status is still displayed. Remove: The status is removed. When this option is used, the completion behavior must be set to Incomplete (if not, an error will occur). Reset: When a status is assigned to a checklist item, its checkbox is checked; if that item’s checkbox is later unchecked, the status is removed. When this option is used, the completion behavior must be set to Complete (if not, an error will occur, as the Complete behavior is what ensures that the checkbox gets checked). For example, the Reset behavior could be used so that once the “Done” status is assigned to an item, its checkbox is automatically checked. If that box is later unchecked, the “Done” status is automatically removed.

Reordering statuses

Statuses can be reordered, which changes the order in which they appear in the status drop-down.

To move the statuses into a new order:

Click on the handle next to a status and drag and drop it into a new location.

Deleting statuses

When you delete a status, any checklist items that previously had that status will appear to have no status when the issue is next opened.

To delete a status:

Click the trash icon to the right of the status.