# gh release create

Tag, note, and ship a release.

## Quick answer
```
gh release create v1.0.0 --generate-notes
```

## Syntax
```
gh release create <tag> [<files>...] [flags]
```

## Examples

# Create a release with auto-generated notes
gh release create v1.0.0 --generate-notes

# Attach built binaries
gh release create v1.0.0 ./dist/app-linux ./dist/app-macos

# Title and notes from a file
gh release create v1.0.0 --title "1.0.0" --notes-file CHANGELOG.md

# Publish a prerelease
gh release create v1.1.0-beta --prerelease --generate-notes

# Create a draft to edit before publishing
gh release create v1.0.0 --draft --generate-notes

## Key flags

  -t, --title	Release title.
  -n, --notes	Release notes text.
  -F, --notes-file	Read release notes from a file (- for stdin).
  --generate-notes	Automatically generate notes from merged PRs.
  -d, --draft	Save as a draft instead of publishing.
  -p, --prerelease	Mark the release as a prerelease.
  --target	Target branch or full commit SHA for the tag.
  --latest	Explicitly mark (or not) this as the latest release.

Full guide: https://ghcli.com/gh-release-create.php