Releases are a great way to ship projects on GitHub to your users.

Note: Only users with write access to the repository can view drafts of releases. For more information, see:

  1. On GitHub Enterprise, navigate to the main page of the repository.

  2. Releases tab
    Under your repository name, click Releases.

  3. Releases draft button
    Click Draft a new release.

  4. Releases tagged version
    Type a version number for your release. Versions are based on Git tags. We recommend naming tags that fit within semantic versioning.
  5. Releases tagged branch
    Select a branch that contains the project you want to release. Usually, you'll want to release against your master branch, unless you're releasing beta software.
  6. Releases description
    Type a title and description that describes your release.
  7. Providing a DMG with the Release
    If you'd like to include binary files along with your release, such as compiled programs, drag and drop or select files manually in the binaries box.
  8. Marking it as a prerelease
    If the release is unstable, select This is a pre-release to notify users that it's not ready for production.
  9. Publish or draft release buttons
    If you're ready to publicize your release, click Publish release. Otherwise, click Save draft to work on it later.

Automatically creating releases

If you'd like to automatically create releases (either from the command line or in a script), see "Releases" in the GitHub Developer documentation.

Further reading