Statuses are added to checklist items for information purposes, as they are an easy way to track the progress of tasks within a project.
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.
The name that will be displayed on the status tag.
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.
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
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.
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.
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.
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.
Editing statuses in CSV format
If desired, you can edit your statuses in the CSV editor instead. This makes it easy to export and import any status information that is being kept in a separate CSV file.
Each status must be on one line and have five parameters, each delimited by a comma, in the following order: ID, Name, Style, Completion Behavior, Status Behavior