gh pr create Open a pull request from the current branch

Creates a pull request on GitHub for your branch, asking for a title and description if you do not give them. Push your branch first, or let gh offer to push it.

Synopsis

gh pr create [FLAGS]

Common options

Option or formWhat it does
-t, --title TEXTPull request title
-b, --body TEXTPull request description
-f, --fillTake the title and body from your commits
-B, --base BRANCHThe branch to merge into (default: the repository default)
-r, --reviewer USERRequest a review from someone
-l, --label NAMEAdd a label
-d, --draftOpen it as a draft
-w, --webFinish creating it in the browser

Examples

Create one interactively
gh pr create
Create it quickly from your commit messages
gh pr create --fill
Give a title, body and reviewer
gh pr create --title "Add search" --body "Adds a search box." --reviewer octocat
Target a different branch
gh pr create --base release/1.2
Open in the browser to edit
gh pr create --web

Notes

See also

Last reviewed 2026-10-09.