--- title: '`glab mr create`' stage: AI Clients group: Developer Clients info: To determine the technical writer assigned to the Stage/Group associated with this page, see --- Create a new merge request. ## Synopsis Defaults to the current branch as the source branch. Use `--fill` to automatically fill the title and description from the commit history. Use `--draft` to create a draft merge request. `--attach` uploads a file and references it at the end of the description. Repeat the flag for more than one file, or pass `-` to read the file from standard input. Files upload to the target project, so the references resolve even for a merge request from a fork. The `--attach` flag is an experiment. It might be unstable or removed at any time, and is not ready for production use. For more information, see . The `--recover` flag is an experiment: it might be unstable or removed at any time, and is not ready for production use. For more information, see . ```plaintext glab mr create [flags] ``` ## Aliases ```plaintext new ``` ## Examples ```console # Create a merge request interactively from the current branch glab mr new # Assign a user and set a title without prompting for description glab mr create -a username -t "fix annoying bug" # Fill title and description from commits, mark as draft, add a label glab mr create -f --draft --label RFC # Fill from commits and preview the compare page in the browser glab mr create --fill --web # Fill from commits, expand each commit body into the description glab mr create --fill --fill-commit-body --yes # Fill from commits without pushing, for a branch already on the remote glab mr create --fill --push=false --yes # Use a merge request template for the description glab mr create -t "Fix login bug" --template bug_fix glab mr create -t "Security patch" --template security_fix.md --yes # Use a template file from outside the repository glab mr create -t "Fix login bug" --template ~/team-templates/bug_fix.md # Create against another project without a local clone. All inputs must be passed as flags; no --push, --fill, or --template. glab mr create --repo group/project --source-branch feature-branch --target-branch main --title "Add feature" --description "Details..." --yes # Create a fork merge request from your fork into the upstream project, without a local clone. glab mr create --repo upstream/project --head your-namespace/project --source-branch feature-branch --target-branch main --title "Add feature" --description "Details..." --yes # Read the description from a file glab mr create -t "Fix login bug" --description-file description.md # Read the description from standard input cat description.md | glab mr create -t "Fix login bug" --description-file - # Attach a screenshot to the description glab mr create -t "Fix login bug" -d "Before and after:" --attach ./before.png --attach ./after.png ``` ## Options ```plaintext --allow-collaboration Allow commits from other members. Set to true/false to override project defaults, or omit to use project settings. -a, --assignee usernames Assign merge request to people by their usernames. Multiple usernames can be comma-separated or specified by repeating the flag. --attach stringArray (EXPERIMENTAL) Upload a file and reference it at the end of the description. Use "-" to read the file from standard input. Repeat the flag to attach multiple files. --auto-merge Set the merge request to merge when all merge checks pass. --copy-issue-labels Copy labels from issue to the merge request. Used with --related-issue. --create-source-branch Create a source branch if it does not exist. -d, --description string Supply a description for the merge request. Set to "-" to open an editor. --description-file string Read the merge request description from a file. Use "-" to read from standard input. --draft Mark merge request as a draft. -f, --fill Do not prompt for title or description, and just use commit info. Pushes the branch unless --push=false is set. --fill-commit-body Fill description with each commit body when multiple commits. Can only be used with --fill. -H, --head OWNER/REPO Select another head repository using the OWNER/REPO or `GROUP/NAMESPACE/REPO` format, the project ID, or the full URL. -l, --label strings Add label by name. Multiple labels can be comma-separated or specified by repeating the flag. -m, --milestone string The global ID or title of a milestone to assign. --no-editor Don't open editor to enter a description. If true, uses prompt. Defaults to false. --push Push committed changes before creating the merge request. Make sure you have committed changes. Defaults to true with --fill. Use --push=false to skip the push. --recover Save the options to a file if the merge request creation fails. If the file exists, the options are loaded from the recovery file. (EXPERIMENTAL) -i, --related-issue string Create a merge request for an issue. If --title is not provided, uses the issue title. --remove-source-branch Remove source branch on merge. Set to true/false to override project defaults, or omit to use project settings. --reviewer usernames Request review from users by their usernames. Multiple usernames can be comma-separated or specified by repeating the flag. --signoff Append a DCO signoff to the merge request description. -s, --source-branch string Create a merge request from this branch. Default is the current branch. --squash-before-merge Squash commits into a single commit when merging. Set to true/false to override project defaults, or omit to use project settings. -b, --target-branch string The target or base branch into which you want your code merged into. --template string Template to pre-populate the description. A name is looked up in '.gitlab/merge_request_templates/' of the local repository, and the '.md' extension is optional. A value that is absolute or contains a path separator is read as a file path, for example '~/templates/feature.md'. -t, --title string Supply a title for the merge request. -w, --web Continue merge request creation in a browser. --wip Mark merge request as a draft. Alternative to --draft. -y, --yes Skip submission confirmation prompt. Use --fill to skip all optional prompts. ``` ## Options inherited from parent commands ```plaintext -h, --help Show help for this command. -R, --repo string Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted. ```