GitLab Todos

Introduced in GitLab 8.5.

When you log into GitLab, you normally want to see where you should spend your time and take some action, or what you need to keep an eye on. All without the mess of a huge pile of e-mail notifications. GitLab is where you do your work, so being able to get started quickly is very important.

Todos is a chronological list of to-dos that are waiting for your input, all in a simple dashboard.

Todos screenshot showing a list of items to check on

You can quickly access the Todos dashboard using the checkmark icon next to the search bar in the upper right corner. The number in blue is the number of Todos you still have open if the count is < 100, else it's 99+. The exact number will still be shown in the body of the To do tab.

Todos icon

What triggers a Todo

A Todo appears in your Todos dashboard when:

  • an issue or merge request is assigned to you,
  • you are @mentioned in an issue, merge request or epic, be it the description of the issue/merge request/epic or in a comment,
  • you are @mentioned in a comment on a commit,
  • a job in the CI pipeline running for your merge request failed, but this job is not allowed to fail.
  • an open merge request becomes unmergeable due to conflict, and you are either:
    • the author, or
    • have set it to automatically merge once pipeline succeeds.

NOTE: Note: When an user no longer has access to a resource related to a Todo like an issue, merge request, project or group the related Todos, for security reasons, gets deleted within the next hour. The delete is delayed to prevent data loss in case user got their access revoked by mistake.

Directly addressed Todos

Introduced in GitLab 9.0.

If you are mentioned at the start of a line, the todo you receive will be listed as 'directly addressed'. For instance, in this comment:

@alice What do you think? cc: @bob

- @carol can you please have a look?

@dan what do you think?

@erin @frank thank you!

The people receiving directly addressed todos are @alice, @erin, and @frank. Directly addressed todos only differ from mention todos in their type, for filtering; otherwise, they appear as normal.

Manually creating a Todo

You can also add an issue, merge request or epic to your Todos dashboard by clicking the "Add todo" button in the issue, merge request or epic sidebar.

Adding a Todo from the issuable sidebar

Marking a Todo as done

Any action to the corresponding issue, merge request or epic will mark your Todo as Done. Actions that dismiss Todos include:

  • changing the assignee
  • changing the milestone
  • adding/removing a label
  • commenting on the issue

Todos are personal, and they're only marked as done if the action is coming from you. If you close the issue or merge request, your Todo will automatically be marked as done.

If someone else closes, merges, or takes action on the issue, epic or merge request, your Todo will remain pending. This prevents other users from closing issues without you being notified.

There is just one Todo per issue, epic or merge request, so mentioning a user a hundred times in an issue will only trigger one Todo.

If no action is needed, you can manually mark the Todo as done by clicking the corresponding Done button, and it will disappear from your Todo list.

A Todo in the Todos dashboard

A Todo can also be marked as done from the issue, merge request or epic sidebar using the "Mark todo as done" button.

Mark todo as done from the issuable sidebar

You can mark all your Todos as done at once by clicking on the Mark all as done button.

Filtering your Todos

There are four kinds of filters you can use on your Todos dashboard.

Filter Description
Project Filter by project
Group Filter by group
Author Filter by the author that triggered the Todo
Type Filter by issue, merge request or epic
Action Filter by the action that triggered the Todo

You can also filter by more than one of these at the same time. The possible Actions are Any Action, Assigned, Mentioned, Added, Pipelines, and Directly Addressed, as described above.