When you’re ready to create a merge request, use a method that fits your workflow. The GitLab UI offers several ways to create a merge request, and methods outside of the UI are also available:
glab mr
command, or Git commands combined with push options.To streamline the process of connecting a merge request to your branch, follow the branch naming patterns when naming your branch.
All methods of creating a merge request enforce your project’s branch naming rules.
From the merge request listYou can create a merge request from the list of merge requests.
Each branch can be associated with only one open merge request. If a merge request already exists for this branch, a link to the existing merge request is shown.
From an issueIf your development workflow requires an issue for every merge request, you can create a branch directly from the issue to speed the process up. The new branch, and later its merge request, are marked as related to this issue. After merging the merge request, the issue is closed automatically, unless automatic issue closing is disabled:
To create a branch and a merge request at the same time:
History
If your team breaks issues into tasks, you can create a branch directly from the task to speed the process up. The new branch, and later its merge request, are marked as related to this task. After merging the merge request, the task is closed automatically, unless automatic issue closing is disabled:
Prerequisites:
To create a branch and a merge request at the same time:
If your Git repository is empty, GitLab:
README.md
file to it..gitlab-ci.yml
file.If the name of the branch you create is prefixed with the task number, GitLab cross-links the issue and merge request, and adds the closing pattern to the description of the merge request. In most cases, this looks like Closes #ID
, where ID
is the ID of the task. If your project is configured with a closing pattern, the task closes when the merge request merges.
You can create a merge request when you do the following from the Web Editor:
When you create a branchYou can create a merge request when you create a branch.
You can create a merge request from your fork to contribute back to the main project.
On the left sidebar, select Search or go to and find your fork.
Select Code > Merge requests, and select New merge request.
For Source branch, select the branch in your fork that contains your changes.
For Target branch:
Select the upstream repository, and not your fork. If you contribute changes upstream frequently, consider setting a default target for your fork.
Select a branch from the upstream repository:
If your fork’s visibility is more restricted than the parent repository, the target branch defaults to your fork’s default branch. This prevents potential exposure of private information in your fork.
Select Compare branches and continue.
Select Create merge request. The merge request is created in the target repository, not your fork.
Add your desired labels, milestones, reviewers, and assignees.
Select Submit merge request.
If the merge request targets another repository, it uses:
To run CI/CD pipelines in the upstream project, you must be a member of that project. If you run a merge request pipeline in the parent project for a merge request from a fork, all variables become available to the pipeline.
After your work merges, unlink your fork from its upstream repository if you don’t intend to make more contributions.
Set the default target projectBy default, merge requests originating from a fork target the upstream repository, not your fork. You can configure your forked repository to be the default target, rather than the upstream repository.
Prerequisites:
To do this:
You can create a merge request by sending an email message to GitLab. The merge request target branch is the repository’s default branch.
Prerequisites:
To create a merge request by sending an email:
On the left sidebar, select Search or go to and find your project.
Select Code > Merge requests.
If the project contains any merge requests, select Email a new merge request to this project.
In the dialog, copy the email address shown. Keep this address private. Anyone who has it can create issues or merge requests as if they were you.
Open an email and compose a message with the following information:
To add commits, attach .patch
files to the message.
Send the email.
A merge request is created.
Add attachments when creating a merge request by emailAdd commits to a merge request by adding patches as attachments to the email.
.patch
.HEAD
, or the default target branch. To change the target branch manually, use the /target_branch
quick action.The option to Create merge request doesn’t display on an issue if:
To make this button appear, one possible workaround is to remove your project’s fork relationship. After removal, you can’t restore the fork relationship. Your project can no longer send or receive merge requests to the source project, or other forks of it.
Email message could not be processedWhen sending an email to create a merge request, and you attempt to target an upstream repository, GitLab responds with this error:
Unfortunately, your email message to GitLab could not be processed.
You are not allowed to perform this action. If you believe this is in error, contact a staff member.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4