2021-12-11 22:18:48 +05:30
---
stage: Plan
group: Project Management
info: 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)**
2022-08-13 15:12:31 +05:30
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/334812) in GitLab 14.5 [with a flag](../administration/feature_flags.md) named `work_items`. Disabled by default.
> - [Creating, editing, and deleting tasks](https://gitlab.com/groups/gitlab-org/-/epics/7169) introduced in GitLab 15.0.
2022-08-27 11:52:29 +05:30
> - [Enabled on GitLab.com and self-managed](https://gitlab.com/gitlab-org/gitlab/-/issues/334812) in GitLab 15.3.
WARNING:
Tasks are in [**Alpha** ](../policy/alpha-beta-support.md#alpha-features ).
The following list are the known limitations:
- [Tasks currently cannot be accessed via REST API. ](https://gitlab.com/gitlab-org/gitlab/-/issues/368055 )
- An issue's tasks can only currently be accessed via a reference within a description, comment, or direct URL (`.../-/work_items/[global_id]`).
For the latest updates, check the [Tasks Roadmap ](https://gitlab.com/groups/gitlab-org/-/epics/7103 ).
2021-12-11 22:18:48 +05:30
FLAG:
2022-08-27 11:52:29 +05:30
On self-managed GitLab, by default this feature is available. To hide the feature,
ask an administrator to [disable the feature flags ](../administration/feature_flags.md ) named `work_items` and `work_items_hierarchy` .
On GitLab.com, this feature is available.
2021-12-11 22:18:48 +05:30
Use tasks to track steps needed for the [issue ](project/issues/index.md ) to be closed.
When planning an issue, you need a way to capture and break down technical
2022-01-26 12:08:38 +05:30
requirements or steps necessary to complete it. An issue with related tasks is better defined,
2021-12-11 22:18:48 +05:30
and so you can provide a more accurate issue weight and completion criteria.
2022-01-26 12:08:38 +05:30
Tasks are a type of work item, a step towards [default issue types ](https://gitlab.com/gitlab-org/gitlab/-/issues/323404 )
in GitLab.
For the roadmap of migrating issues and [epics ](group/epics/index.md )
2021-12-11 22:18:48 +05:30
to work items and adding custom work item types, visit
[epic 6033 ](https://gitlab.com/groups/gitlab-org/-/epics/6033 ) or
[Plan direction page ](https://about.gitlab.com/direction/plan/ ).
2022-07-23 23:45:48 +05:30
## Create a task
To create a task:
1. In an issue description, create a [task list ](markdown.md#task-lists ).
2022-08-13 15:12:31 +05:30
1. Hover over a task item and select **Create task** (**{doc-new}**).
2022-07-23 23:45:48 +05:30
## Edit a task
To edit a task:
1. In the issue description, view the task links.
1. Select a link. The task is displayed.
- To edit the description, select **Edit** , then select **Save** .
2022-08-13 15:12:31 +05:30
- To edit the title or state, make your changes, then select any area outside the field. The changes are saved automatically.
2022-07-23 23:45:48 +05:30
## Delete a task
To delete a task:
2021-12-11 22:18:48 +05:30
2022-07-23 23:45:48 +05:30
1. In the issue description, select the task.
2022-08-13 15:12:31 +05:30
1. From the options menu (**{ellipsis_v}**), select **Delete task** .
