Merge requests
You can browse and filter merge requests for your GitLab repository from the Merge Requests activity.
Navigate the Merge Requests activity
To show the Merge Requests activity, click its activity-bar icon or click DevOps > Merge Requests.
To analyze the same filtered merge requests in a wider view, choose Open as Tab from the activity menu, then use View to select Grid, Board, Timeline, Summary, or another reporting view. Reporting is part of the Merge Requests tab; there is no separate MR Report tab. The export action appears in reporting views.
Merge requests are listed numerically and display the following information.
- State: The status of the merge request, if the merge request is open, closed, or merged.
- Merge request number: The number of the merge request.
- Merge request name: The name of the merge request.
- Timestamp: The amount of time since the merge request was created.
Merge Request view
Click a merge request to open the merge request in the Merge Request view. Click Conversation, Checks, and Changes to change the displayed information of the Merge Request view.
Conversation view
You can view every comment and action of a merge request in the Conversation view. The Conversation view displays the merge request and the following information.
- State: The status of the merge request, if the merge request is open, closed, or merged.
- Milestone: The milestones associated with the merge request.
- Assignees: The users assigned to the merge request.
- Reviewers: The users assigned to review the merge request.
- Labels: The labels attached to the merge request.
- Linked issues: The issues linked to the merge request.
Checks view
Checks are not yet available for GitLab. Open the merge request on the web to view the pipeline status.
Changes view
You can view each changes file in a merge request in the Changes view. You can filter files by status, file type, viewed and unviewed files, and by file name.
Create a new merge request
To create a new merge request, complete the following steps.
- Click DevOps > New MR.
- In the New MR tab, select the base and compare branch.
- In the Title field, enter the merge request name.
- Optional: Add labels, milestones, reviewers, and assignees to the merge request in the Metadata section.
- Enter the merge request description in the Description field and click Create Pull Request.
Filter merge requests
By default, the Merge Requests activity displays all open merge requests in a repository. Click the Switch filter dropdown to select a filter template.
Click the Toggle filter panel icon to open the filter panel. You can filter merge requests with multiple filters at a time. Click Switch to Advanced Query to use GitLab search syntax to apply filters.
Filter panel actions
In the merge request filter panel, click the following icons to perform a filter action.
| Icon | Description |
|---|---|
| Save | Saves the changes to the filter template. |
| Save As | Saves the changes as a new filter template. |
| Rename filter | Renames the filter template. |
| Revert to saved state | Discards changes made to the filter template. |
| Delete this filter | Deletes the filter template. |
| New filter tab | Opens a new Merge Request tab for a new filter template. |
| Duplicate tab | Copies the current filter template to a new Merge Request tab. |