Managing releases in a repository - GitHub Docs (original) (raw)

You can create releases to bundle and deliver iterations of a project to users.

Who can use this feature?

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

About release management

You can create new releases with release notes, @mentions of contributors, and links to binary files, as well as edit or delete existing releases. You can also create, modify, and delete releases by using the Releases API. For more information, see REST API endpoints for releases in the REST API documentation.

You can also publish an action from a specific release in GitHub Marketplace. For more information, see Publishing actions in GitHub Marketplace.

You can choose whether Git Large File Storage (Git LFS) objects are included in the ZIP files and tarballs that GitHub creates for each release. For more information, see Managing Git LFS objects in archives of your repository.

Creating a release

Tip

If you have enabled immutable releases for your repository, it's recommended to create releases as drafts first, attach all assets, and then publish. This ensures all assets are in place before the release becomes immutable. For more information, see Immutable releases.

Editing a release

Note

If you have enabled immutable releases for your repository, you can only edit the title and release notes after a release is published. See Immutable releases.

Deleting a release