GH-RELEASE-CREATE(1)           GitHub CLI manual          GH-RELEASE-CREATE(1)



<?><?><?> (NAME)
       gh-release-create - <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?>



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       gh release create [<tag>] [<filename>... | <pattern>...]



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (GitHub Release) <?><?><?><?> <?><?>
       <?><?><?><?>.


       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (asset) <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?> # <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>.


       <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?> <?><?><?><?><?> --target
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  <?><?> <?><?><?><?><?>
       --verify-tag <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> git fetch --tags origin <?><?>
       <?><?><?><?> <?><?><?><?>.


       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?> (annotated git tag)<?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> (push) <?><?><?><?><?> <?>
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?> <?><?><?><?><?> --notes-from-tag
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.


       <?><?> <?><?><?><?><?> --generate-notes <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> API <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>.  <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?>. <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> --notes <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.


       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.  <?><?> <?><?><?><?><?>
       --fail-on-no-commits <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>.



<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (Immutable
       Releases)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>:

       o <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
         <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
         <?><?><?><?><?><?>.

       o <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
         <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.


       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (draft)
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?>.


       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> create
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> API <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?>.



<?><?><?><?><?><?><?><?> (OPTIONS)
       --discussion-category <string>
              <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>


       -d, --draft
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?>


       --fail-on-no-commits
              <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> (<?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?>)


       --generate-notes
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?> API <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>


       --latest
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> "Latest" (<?><?><?><?><?> <?><?><?><?>)
              (<?><?><?><?><?><?><?> [<?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?> <?><?><?><?>]). <?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> latest=false--
              <?><?><?><?><?><?><?> <?><?><?><?>


       -n, --notes <string>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>


       -F, --notes-file <file>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?> (<?><?> "-" <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>)


       --notes-from-tag
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?>


       --notes-start-tag <string>
              <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>


       -p, --prerelease
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?>


       --target <branch>
              <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> SHA
              <?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?><?><?>
              [<?><?><?><?> <?><?><?><?> main])


       -t, --title <string>
              <?><?><?><?><?> <?><?><?><?><?><?>


       --verify-tag
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?> <?><?><?> <?><?>
              <?><?><?><?> <?><?><?> <?><?><?> (remote) <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?>



<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> (OPTIONS INHERITED FROM PARENT COMMANDS)
       -R, --repo <[HOST/]OWNER/REPO>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> [HOST/]OWNER/REPO



<?><?><?><?><?><?><?> <?><?><?><?><?><?> (ALIASES)
       gh release new



<?><?><?><?><?> <?><?><?><?> (EXIT CODES)
       0: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>


       1: <?><?><?>


       2: <?><?><?><?><?> <?><?><?> <?><?>


       4: <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>


       <?><?><?><?>: <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>.



<?><?><?><?><?><?><?> (EXAMPLES)
       # <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       $ gh release create

       # <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       $ gh release create v1.2.3

       # <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       $ gh release create v1.2.3 --notes "bugfix release"

       # <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> API <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       $ gh release create v1.2.3 --generate-notes

       # <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       $ gh release create v1.2.3 -F release-notes.md

       # <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       $ gh release create v1.2.3 --notes-from-tag

       # <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       $ gh release create v1.2.3 --latest=false

       # <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> tarball <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       $ gh release create v1.2.3 ./dist/*.tgz

       # <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       $ gh release create v1.2.3 '/path/to/asset.zip#My display label'

       # <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?> <?><?><?><?> <?><?> <?><?><?>
       $ gh release create v1.2.3 --discussion-category "General"

       # <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       $ gh release create v1.2.3 --fail-on-no-commits




<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       gh-release(1)

                                   Sep 2026               GH-RELEASE-CREATE(1)