Due dates
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Use due dates in work items to track deadlines, and make sure features are shipped on time.
Due dates are supported in:
The day before an open item is due, an email is sent to all participants. Like the due date, the “day before the due date” is determined by the server’s time zone.
Due dates also appear in your to-do items.
View issues with due dates
You can see issues with their due dates on the Issues 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 ( ).
To view and sort issues containing due dates in your project:
- On the left sidebar, select Search or go to and find your project.
- Select Plan > Issues.
- To sort by due date, select the current sort method, then select Due date.
- Optional. To reverse the sort order, select Sort direction ( ).
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 at least the Planner 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 at least the Planner role.
To do this:
- On the left sidebar, select Search or go to and find your project.
- Select Plan > Issues, then select the title of your issue to view it.
- On the right sidebar, next to Due date, select Edit to display a calendar.
- Select your desired date, then select again, outside the calendar, to save your changes.
With a quick action
To set a due date from a quick action in an issue’s description or comment:
/due <date>
: Set the due date. Examples of valid<date>
includein 2 days
,this Friday
, andDecember 31st
./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 Issues page
- The Group Issues page
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
On the right, from the Actions ( ) dropdown list, select Subscribe to calendar to display the
.ics
file.Copy the full link to the page (including the full query string) and use it in your preferred calendar application.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support