2019-10-28 06:06:30 +00:00
---
disqus_identifier: 'https://docs.gitlab.com/ee/workflow/todos.html'
2020-05-27 03:08:26 +00:00
stage: Plan
group: Project Management
2020-11-26 06:09:20 +00:00
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
2019-10-28 06:06:30 +00:00
---
2021-01-28 06:08:59 +00:00
# GitLab To-Do List **(FREE)**
2019-10-28 06:06:30 +00:00
2020-04-01 03:07:57 +00:00
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/2817) in GitLab 8.5.
2019-10-28 06:06:30 +00:00
2020-09-16 15:09:32 +00:00
When you sign in to GitLab, you normally want to determine where you should
spend your time. This can include taking an action, or keeping track of things
(without having to read lots of email notifications). Because GitLab is where you
do your work, being able to get started quickly is important.
2019-10-28 06:06:30 +00:00
2020-09-16 15:09:32 +00:00
Your *To-Do List* offers a chronological list of items waiting for your input
2020-10-28 18:08:52 +00:00
(known as *to-do items* ) in a single dashboard.
2019-10-28 06:06:30 +00:00
2020-10-28 18:08:52 +00:00
The To-Do List supports tracking [actions ](#what-triggers-a-to-do-item ) related to
2020-09-16 15:09:32 +00:00
the following:
2019-10-28 06:06:30 +00:00
2020-09-16 15:09:32 +00:00
- Issues
- Merge Requests
- Epics ** (ULTIMATE)**
2019-10-28 06:06:30 +00:00
2020-09-16 15:09:32 +00:00
![to-do screenshot showing a list of items to check on ](img/todos_index.png )
2020-09-21 18:09:58 +00:00
You can access your To-Do List by clicking the To-Do List icon (**{task-done}**)
2020-10-28 18:08:52 +00:00
next to the search bar in the top navigation. If the to-do item count is:
2020-09-16 15:09:32 +00:00
2020-10-28 18:08:52 +00:00
- *Less than 100*, the number in blue is the number of to-do items.
2020-09-16 15:09:32 +00:00
- *100 or more*, the number displays as 99+. The exact number displays in the
To-Do List.
2019-10-28 06:06:30 +00:00
![To Do icon ](img/todos_icon.png )
2020-10-28 18:08:52 +00:00
## What triggers a to-do item
2019-10-28 06:06:30 +00:00
2020-10-28 18:08:52 +00:00
A to-do item appears on your To-Do List when:
2019-10-28 06:06:30 +00:00
2020-09-16 15:09:32 +00:00
- An issue or merge request is assigned to you.
- You're `@mentioned` in the description or comment of an issue or merge request
(or epic ** (ULTIMATE)**).
2020-04-21 15:21:10 +00:00
- You are `@mentioned` in a comment on a:
- Commit
2020-05-15 15:08:04 +00:00
- Design
2020-09-16 15:09:32 +00:00
- The CI/CD pipeline for your merge request failed.
- An open merge request becomes unmergeable due to conflict, and one of the
following is true:
- You're the author.
- You're the user that set the merge request to automatically merge after a
pipeline succeeds.
2020-10-15 00:08:42 +00:00
- [In GitLab 13.2 ](https://gitlab.com/gitlab-org/gitlab/-/issues/12136 ) and later, a
2020-09-16 15:09:32 +00:00
merge request is removed from a
[merge train ](../ci/merge_request_pipelines/pipelines_for_merged_results/merge_trains/index.md ),
and you're the user that added it. ** (PREMIUM)**
When several trigger actions occur for the same user on the same object (for
2020-09-21 18:09:58 +00:00
example, an issue), GitLab displays only the first action as a single to do
2020-09-16 15:09:32 +00:00
item.
2020-10-28 18:08:52 +00:00
To-do item triggers aren't affected by [GitLab notification email settings ](profile/notifications.md ).
2019-10-28 06:06:30 +00:00
2020-12-04 21:09:29 +00:00
NOTE:
2020-10-28 18:08:52 +00:00
When a user no longer has access to a resource related to a to-do item (such as
2020-12-07 21:10:08 +00:00
an issue, merge request, epic, project, or group), for security reasons GitLab
2020-10-28 18:08:52 +00:00
deletes any related to-do items within the next hour. Deletion is delayed to
2020-09-21 18:09:58 +00:00
prevent data loss, in the case where a user's access is accidentally revoked.
2019-10-28 06:06:30 +00:00
2020-10-28 18:08:52 +00:00
### Directly addressing a to-do item
2019-10-28 06:06:30 +00:00
2020-04-01 03:07:57 +00:00
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/7926) in GitLab 9.0.
2019-10-28 06:06:30 +00:00
2021-01-12 00:10:42 +00:00
If you're mentioned at the start of a line, the to-do item you receive is
2020-09-21 18:09:58 +00:00
listed as *directly addressed* . For example, in the following comment:
2019-10-28 06:06:30 +00:00
```markdown
@alice What do you think? cc: @bob
- @carol can you please have a look?
>>>
@dan what do you think?
>>>
@erin @frank thank you!
```
2020-10-28 18:08:52 +00:00
The people receiving directly addressed to-do items are `@alice` , `@erin` , and
`@frank` . Directly addressed to-do items only differ from mentions in their type
2019-10-28 06:06:30 +00:00
for filtering purposes; otherwise, they appear as normal.
2020-10-28 18:08:52 +00:00
### Manually creating a to-do item
2019-10-28 06:06:30 +00:00
2020-10-08 09:08:40 +00:00
You can also add the following to your To-Do List by clicking the **Add a to do** button on an:
- [Issue ](project/issues/index.md )
- [Merge Request ](project/merge_requests/index.md )
- [Epic ](group/epics/index.md ) ** (ULTIMATE)**
- [Design ](project/issues/design_management.md )
2019-10-28 06:06:30 +00:00
2020-10-28 18:08:52 +00:00
![Adding a to-do item from the issuable sidebar ](img/todos_add_todo_sidebar.png )
2019-10-28 06:06:30 +00:00
2020-10-28 18:08:52 +00:00
## Marking a to-do item as done
2019-10-28 06:06:30 +00:00
2020-12-07 18:10:36 +00:00
Any action to an issue or merge request (or epic ** (PREMIUM)**) marks its
2020-10-28 18:08:52 +00:00
corresponding to-do item as done.
2019-10-28 06:06:30 +00:00
2020-10-28 18:08:52 +00:00
Actions that dismiss to-do items include:
2019-10-28 06:06:30 +00:00
- Changing the assignee
- Changing the milestone
- Adding/removing a label
- Commenting on the issue
2020-09-16 15:09:32 +00:00
Your To-Do List is personal, and items are only marked as done if you take
2020-10-28 18:08:52 +00:00
action. If you close the issue or merge request, your to-do item is marked as
2020-09-21 18:09:58 +00:00
done.
2019-10-28 06:06:30 +00:00
2020-09-16 15:09:32 +00:00
To prevent other users from closing issues without you being notified, if
someone else closes, merges, or takes action on an issue or merge request (or
2020-10-28 18:08:52 +00:00
epic ** (ULTIMATE)**), your to-do item remains pending.
2019-10-28 06:06:30 +00:00
2020-10-28 18:08:52 +00:00
There's just one to-do item for each of these, so mentioning a user many times
in an issue only triggers one to-do item.
2019-10-28 06:06:30 +00:00
2020-10-28 18:08:52 +00:00
If no action is needed, you can manually mark the to-do item as done by
2020-09-21 18:09:58 +00:00
clicking its corresponding **Done** button to have GitLab remove the item from
your To-Do List.
2019-10-28 06:06:30 +00:00
2020-10-02 18:08:56 +00:00
![A to do in the To-Do List ](img/todos_todo_list_item.png )
2019-10-28 06:06:30 +00:00
2020-10-28 18:08:52 +00:00
You can also mark a to-do item as done by clicking the **Mark as done** button
2020-09-21 18:09:58 +00:00
in the sidebar of an issue or merge request (or epic ** (ULTIMATE)**).
2019-10-28 06:06:30 +00:00
![Mark as done from the issuable sidebar ](img/todos_mark_done_sidebar.png )
2020-10-28 18:08:52 +00:00
You can mark all your to-do items as done at once by clicking the
2020-09-16 15:09:32 +00:00
**Mark all as done** button.
2019-10-28 06:06:30 +00:00
## Filtering your To-Do List
2020-09-16 15:09:32 +00:00
You can use the following types of filters with your To-Do List:
2019-10-28 06:06:30 +00:00
2020-09-16 15:09:32 +00:00
| Filter | Description |
| ------- | ---------------------------------------------------------------- |
| Project | Filter by project. |
| Group | Filter by group. |
2020-10-02 18:08:56 +00:00
| Author | Filter by the author that triggered the to do. |
2020-09-16 15:09:32 +00:00
| Type | Filter by issue, merge request, design, or epic. ** (ULTIMATE)** |
2020-10-02 18:08:56 +00:00
| Action | Filter by the action that triggered the to do. |
2019-10-28 06:06:30 +00:00
2020-09-16 15:09:32 +00:00
You can also filter by more than one of these at the same time. The previously
2020-10-28 18:08:52 +00:00
described [triggering actions ](#what-triggers-a-to-do-item ) include:
2019-10-28 06:06:30 +00:00
2020-09-16 15:09:32 +00:00
- Any action
2020-04-01 03:07:57 +00:00
- Assigned
- Mentioned
- Added
- Pipelines
2020-09-16 15:09:32 +00:00
- Directly addressed