Draft merge requests (FREE)

If a merge request isn't ready to merge, potentially because of continued development or open threads, you can prevent it from being accepted before you mark it as ready. Flag it as a draft to disable the Merge button until you remove the Draft flag:

Blocked Merge Button

Mark merge requests as drafts

  • Introduced in GitLab 13.2, Work-In-Progress (WIP) merge requests were renamed to Draft.
  • Removed all support for using WIP in GitLab 14.8.
  • Mark as draft and Mark as ready buttons introduced in GitLab 13.5.

There are several ways to flag a merge request as a draft:

  • Viewing a merge request: In the top right corner of the merge request, select Mark as draft.
  • Creating or editing a merge request: Add [Draft], Draft: or (Draft) to the beginning of the merge request's title, or select Start the title with Draft: below the Title field.
  • Commenting in an existing merge request: Add the /draft quick action in a comment. This quick action is a toggle, and can be repeated to change the status back to Ready.
  • Creating a commit: Add draft:, Draft:, fixup!, or Fixup! to the beginning of a commit message targeting the merge request's source branch. This is not a toggle, and adding this text again in a later commit doesn't mark the merge request as ready.

Mark merge requests as ready

When a merge request is ready to be merged, you can remove the Draft flag in several ways:

  • Viewing a merge request: In the top right corner of the merge request, select Mark as ready. Users with at least the Developer role can also scroll to the bottom of the merge request description and select Mark as ready:

    Mark as ready

  • Editing an existing merge request: Remove [Draft], Draft: or (Draft) from the beginning of the title, or select Remove the Draft: prefix from the title below the Title field.

  • Commenting in an existing merge request: Add the /ready quick action in a comment in the merge request.

In GitLab 13.10 and later, when you mark a merge request as ready, notifications are triggered to merge request participants and watchers.

Include or exclude drafts when searching

When viewing or searching in your project's merge requests list, you can include or exclude draft merge requests:

  1. Go to your project and select Merge requests.

  2. In the navigation bar, select Open, Merged, Closed, or All to filter by merge request status.

  3. Select the search box to display a list of filters and select Draft, or enter the word draft.

  4. Select =.

  5. Select Yes to include drafts, or No to exclude, and press Return to update the list of merge requests:

    Filter draft merge requests

Pipelines for drafts

When the merged results pipelines feature is enabled, draft merge requests run merge request pipelines only.

To run merged results pipelines, you must mark the merge request as ready.