Create a merge request

Now you’re ready to push changes from the community fork to the main GitLab repository!

View an interactive demo of this step.

  1. Go to the community fork on GitLab.com. You should see a message like this one:

    Create merge request banner

    Select Create merge request. If you don’t see this message, on the left sidebar, select Code > Merge requests > New merge request.

  2. Take a look at the branch names. You should be merging from your branch in the community fork to the master branch in the GitLab repository.

    New merge request

  3. Fill out the information and then select Save changes. Don’t worry if your merge request is not complete.

    If you don’t want anyone from GitLab to review it, you can select the Mark as draft checkbox. If you’re not happy with the merge request after you create it, you can close it, no harm done.

  4. Select the Changes tab. It should look something like this:

    Changes tab

    The red text shows the code before you made changes. The green shows what the code looks like now.

  5. If you’re happy with this merge request and want to start the review process, type @gitlab-bot ready in a comment and then select Comment.

    GitLab bot ready comment

Someone from GitLab will look at your request and let you know what the next steps are.

Complete the review process

After you create a merge request, GitLab automatically triggers a CI/CD pipeline that runs tests, linting, security scans, and more.

Your pipeline must be successful for your merge request to be merged.

  • To check the status of your pipeline, at the top of your merge request, select Pipelines.
  • If you need help understanding or fixing the pipeline, in a comment, use the @gitlab-bot help command.

Getting a review

GitLab will triage your merge request automatically. However, you can type @gitlab-bot ready in a comment to alert reviewers that your MR is ready.

  • When the label is set to workflow::ready for review, a developer reviews the MR.
  • After you have resolved all of their feedback and the MR has been approved, the MR is ready for merge.

If you need help at any point in the process, type @gitlab-bot help in a comment or initiate a mentor session on Discord.

When the merge request is merged, your change becomes part of the GitLab codebase. Great job! Thank you for your contribution!