Skip to content

Status

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

Version history

The availability of this feature is controlled by a feature flag. For more information, see the history.

Work item status represents a specific step in a work item's workflow, such as In progress, Done, or Won't do. Status provides more granular tracking than the traditional binary open/closed state system used in GitLab Free.

For a video overview, see Configurable Status for Issues and Tasks - Complete Walkthrough (GitLab 18.2).

Use status to:

  • Track work items through different stages of completion.
  • Provide clearer visibility into work item progress.
  • Replace the need for labels to manage work item lifecycles.
  • Standardize workflows across teams and projects.

Status is available for tasks and issues. For information on plans to add status to epics and other work item types, see epic 5099.

Default statuses

GitLab provides default statuses to get you started with work item tracking. These statuses cannot be modified.

The default statuses are:

  • To do: Work item is ready to be started.
  • In progress: Work item is being actively worked on.
  • Done: Work item has been completed.
  • Won't do: Work item will not be completed.
  • Duplicate: Work item is a duplicate of another item.

Status categories

Status categories are logical groupings that determine how a status affects a work item's state and icon. Each status belongs to one of five categories:

  • Triage: For new or unprocessed work items.
  • To do: For work items ready to be started.
  • In progress: For work items being actively worked on.
  • Done: For completed work items.
  • Canceled: For work items that won't be completed.

Statuses in the Done and Canceled categories automatically set work items to closed state. All other categories maintain work items in open state.

Lifecycles

A lifecycle is a collection of statuses that can be applied to a work item type. Lifecycles group statuses into meaningful workflows that can be reused consistently across work item types and namespaces.

Each lifecycle defines default transition statuses:

  • Default open status: Applied when creating and reopening work items.
  • Default closed status: Applied when closing work items.
  • Default duplicated status: Applied when marking work items as duplicates, moved, or promoted.

Custom statuses

Custom statuses are namespace-defined statuses that replace default statuses for all groups and projects in that namespace. When you edit a lifecycle, custom statuses replace the default statuses for that namespace.

Custom statuses have the following limits:

  • Maximum 70 statuses per namespace
  • Maximum 30 statuses per lifecycle

Configure custom statuses for a namespace

Configure custom statuses for top-level groups to make them available for work items in that group, its subgroups, and projects.

Prerequisites:

  • You must have at least the Maintainer role for the group.
  • This group must be at the top level.

To configure custom statuses:

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > Issues.
  3. In the Statuses section, select Edit statuses.
  4. Add, edit, or reorder statuses for the namespace.
  5. Select Close.

Set status for a work item

Prerequisites:

  • You must have at least the Planner role for the work item's project or group, be the author of the work item, or be assigned to the work item.

To set a status for a work item:

  1. Go to an issue or task.
  2. On the right sidebar, in the Status section, select Edit.
  3. Select the desired status.
  4. Select any area outside the dropdown list.

The work item's status updates immediately.