- Adding the “Work In Progress” flag to a merge request
- Removing the “Work In Progress” flag from a merge request
- Including/excluding WIP merge requests when searching
“Work In Progress” merge requests
If a merge request is not yet ready to be merged, perhaps due to continued development or open threads, you can prevent it from being accepted before it’s ready by flagging it as a Work In Progress. This will disable the “Merge” button, preventing it from being merged, and it will stay disabled until the “WIP” flag has been removed.
Adding the “Work In Progress” flag to a merge request
There are several ways to flag a merge request as a Work In Progress:
- Add
[WIP]
orWIP:
to the start of the merge request’s title. Clicking on Start the title with WIP:, under the title box, when editing the merge request’s description will have the same effect. - Add the
/wip
quick action in a comment in the merge request. This is a toggle, and can be repeated to change the status back. Note that any other text in the comment will be discarded. - Add “wip” or “WIP” to the start of a commit message targeting the merge request’s source branch. This is not a toggle, and doing it again in another commit will have no effect.
Removing the “Work In Progress” flag from a merge request
Similar to above, when a Merge Request is ready to be merged, you can remove the “Work in Progress” flag in several ways:
- Remove
[WIP]
orWIP:
from the start of the merge request’s title. Clicking on Remove the WIP: prefix from the title, under the title box, when editing the merge request’s description, will have the same effect. - Add the
/wip
quick action in a comment in the merge request. This is a toggle, and can be repeated to change the status back. Note that any other text in the comment will be discarded. - Click on the Resolve WIP status button near the bottom of the merge request description, next to the “Merge” button (see image above). Must have at least Developer level permissions on the project for the button to be visible.
Including/excluding WIP merge requests when searching
When viewing/searching the merge requests list, you can choose to include or exclude WIP merge requests by adding a “WIP” filter in the search box, and choosing “Yes” (to include) or “No” (to exclude).
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc