Due dates

{{< details >}}

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

{{< /details >}}

{{< history >}}

• Minimum role to set due dates changed from Reporter to Planner in GitLab 17.7.

{{< /history >}}

Use due dates in work items to track deadlines, and make sure features are shipped on time.

Due dates are supported in:

• Issues
• Epics
• Tasks
• Objectives and key results
• Incidents

The day before an open item is due, an email is sent to all participants.

<!-- For issue due timing source, see 'issue_due_scheduler_worker' in <https://gitlab.com/gitlab-org/gitlab/-/blob/master/config/initializers/1_settings.rb> -->

The notification is sent at 00:50 in the server's time zone (for GitLab.com this is UTC) for all open items with a due date of the next calendar day.

Due dates also appear in your to-do items.

View issues with due dates

You can see issues with their due dates on the Work items page. If an issue contains a due date, it is shown below the issue title:

Issue dates in the past are shown with a red icon ({{< icon name="calendar-overdue" >}}).

To view and sort issues containing due dates in your project:

1. In the top bar, select Search or go to and find your project.
2. Select Plan > Work items and filter by Type = Issue.
3. To sort by due date, select the current sort method, then select Due date.
4. Optional. To reverse the sort order, select Sort direction ({{< icon name="sort-lowest" >}}).

Set a due date for an issue

All users with permission to view the issue can view its due date.

When creating an issue

If you have the Planner, Reporter, Developer, Maintainer, or Owner role, when creating an issue, select Due date to show a calendar. This date uses the server's time zone, not the current user's time zone.

To remove the date, select the date text, then delete the text.

In an existing issue

Prerequisites:

• You must have the Planner, Reporter, Developer, Maintainer, or Owner role.

To do this:

1. In the top bar, select Search or go to and find your project.
2. Select Plan > Work items, then filter by Type = Issue and select your issue.
3. In the right sidebar, in the Dates section, select Edit.
4. Select your desired date, then select Apply to save your changes.

With a quick action

To set a due date with quick actions in an issue's description or comment:

• /due: Set the due date.
• /remove_due_date: Remove an existing due date.

Export issue due dates to a calendar

Issues with due dates can also be exported as an iCalendar feed. The URL of the feed can be added to calendar applications.

• The Project work items page
• The Group work items page

1. Go to the page that contains the list of issues you want to subscribe to. For example:

   • Issues assigned to you
   • Issues in a specific project
   • Issues for all projects in a group

2. On the right, from the Actions ({{< icon name="ellipsis_v" >}}) dropdown list, select Subscribe to calendar to display the .ics file.

3. Copy the full link to the page (including the full query string) and use it in your preferred calendar application.