How to create a merge request

Merge requests are how you integrate separate changes that you've made in a branch to a project.

This is a brief guide on how to create a merge request. For more detailed information, check the merge requests documentation, or you can watch our GitLab Flow video for a quick overview of working with merge requests.

  1. Before you start, you should have already created a branch and pushed your changes to GitLab.

  2. Go to the project where you'd like to merge your changes and click on the Merge requests tab.

  3. Click on New merge request on the right side of the screen.

  4. From there, you have the option to select the source branch and the target branch you'd like to compare to. The default target project is the upstream repository, but you can choose to compare across any of its forks.

    Select a branch

  5. When ready, click on the Compare branches and continue button.

  6. At a minimum, add a title and a description to your merge request. Optionally, select a user to review your merge request. You may also select a milestone and labels.

    New merge request page

  7. When ready, click on the Submit merge request button.

Your merge request will be ready to be reviewed, approved, and merged.