gitlab-org--gitlab-foss/doc/user/tasks.md

stage	group	info
Plan	Project Management	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Tasks (FREE)

Introduced in GitLab 14.5 with a flag named work_items. Disabled by default.

FLAG: On self-managed GitLab, by default this feature is not available. To make it available, ask an administrator to enable the feature flag named work_items. On GitLab.com, this feature is not available. The feature is not ready for production use.

Use tasks to track steps needed for the issue to be closed.

When planning an issue, you need a way to capture and break down technical requirements or steps necessary to complete it. An issue with related tasks is better defined, and so you can provide a more accurate issue weight and completion criteria.

Tasks are a type of work item, a step towards default issue types in GitLab. For the roadmap of migrating issues and epics to work items and adding custom work item types, visit epic 6033 or Plan direction page.

Create a task

To create a task:

1. In an issue description, create a task list.
2. Hover over a task item and select Convert to work item ({doc-new}).
3. Confirm or edit the title, and select Create work item.

Edit a task

To edit a task:

1. In the issue description, view the task links.
2. Select a link. The task is displayed.
   • To edit the description, select Edit, then select Save.
   • To edit the title or state, make your changes, then click outside the field. The changes are saved automatically.

Delete a task

To delete a task:

1. In the issue description, select the task.
2. From the options menu ({ellipsis_v}), select Delete work item.