Skip to main content

Creating and Editing Merge Requests

Creating a Merge Request

Open the Create Merge Request dialog in one of these ways:

  • Click Create Merge Request in the GitLab Merge Requests tool window toolbar.
  • Right-click a merge request in the list and select Create Merge Request.

Source repository offers the repository's forks as well, and Destination branch defaults to the repository's main development branch. Reviewers requires GitLab 13.9 or later, and whether you can add several assignees and reviewers or only one of each depends on your GitLab edition.

When you set or change the source and destination branches, the plugin suggests a Title, Description, and default Reviewers from the commits between the two branches, replacing only the fields you haven't edited yourself.

Mark as draft requires GitLab 13.12 or later. The plugin remembers your last choice for the delete-source-branch and squash options.

Title and Description

The description is Markdown, accepts pasted images, and typing @ mentions a user.

The Actions link next to the Description label offers:

  • Insert Commits at Caret — insert a summary of the commits between the source and destination branches at the cursor position. Available when the source is the repository itself, not a fork.
  • Reset to Default — apply the project's default merge request description template, when one is configured.
  • Use Template — fill the description from one of the project's description templates. Requires GitLab 13.3 or later.

Editing a Merge Request

To edit an existing merge request, open it and click Edit Merge Request on the Info tab toolbar. The same dialog opens, pre-filled with the current values.

The source repository and source branch can't be changed.