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.

Then fill in the dialog:

Field	Description
Source repository	The repository the changes come from. If the repository has forks, you can select a fork as the source.
Source branch	The branch with your changes. Start typing to get branch-name completion.
Destination branch	The branch you want to merge into. Defaults to the repository's main development branch.
Title	The merge request title.
Description	A Markdown description. See Title and description.
Assignees	People responsible for the merge request.
Reviewers	People asked to review the merge request. Requires GitLab 13.9 or later.
Labels	Labels to apply to the merge request.

Depending on your GitLab edition, you can add either a single assignee and reviewer or several of each.

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

The following options are also available:

• Mark as draft — create the merge request as a draft. Requires GitLab 13.12 or later.
• Delete source branch when merge request is accepted.
• Squash commits when merge request is accepted.

The plugin remembers your last choice for the delete-source-branch and squash options.

Click OK to create the merge request. A notification confirms the new merge request and lets you open it or copy its link.

Title and Description

The description editor supports Markdown formatting (using the toolbar above it), lets you mention users by typing @, and accepts pasted images.

When creating a merge request, 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.

You can change the title, description, destination branch, assignees, reviewers, labels, draft status, and the merge options. The source repository and source branch can't be changed. OK stays disabled until you make a change.