docs/content/github/administering-a-repository/managing-releases-in-a-repository.md

title	intro	redirect_from	permissions	versions
Managing releases in a repository	You can create releases to bundle and deliver iterations of a project to users.	[/articles/creating-releases /articles/listing-and-editing-releases/ /articles/editing-and-deleting-releases /articles/managing-releases-in-a-repository /github/administering-a-repository/creating-releases /github/administering-a-repository/editing-and-deleting-releases]	Repository collaborators and people with write access to a repository can create, edit, and delete a release.	[{free-pro-team *} {enterprise-server *} {github-ae *}]

{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" or currentVersion ver_gt "github-ae@latest" %}

About release management

{% if currentVersion == "free-pro-team@latest" %} You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. For more information, see "Publishing an action in the {% data variables.product.prodname_marketplace %}." {% endif %}

You can choose whether {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) objects are included in the ZIP files and tarballs that {% data variables.product.product_name %} creates for each release. For more information, see "Managing {% data variables.large_files.product_name_short %} objects in archives of your repository." {% endif %}

{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %}

Tip: You can also manage releases using the {% data variables.product.prodname_cli %}. For more information, see "gh release" in the {% data variables.product.prodname_cli %} documentation.

{% endtip %} {% endif %}

Creating a release

{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.releases %} 3. Click Draft a new release. 4. Type a version number for your release. Versions are based on Git tags. We recommend naming tags that fit within semantic versioning. 5. Use the drop-down menu to select the branch that contains the project you want to release. 6. Type a title and description for your release. 7. Optionally, to include binary files such as compiled programs in your release, drag and drop or manually select files in the binaries box. 8. To notify users that the release is not ready for production and may be unstable, select This is a pre-release. 9. If you're ready to publicize your release, click Publish release. To work on the release later, click Save draft.

You can also automatically create a release from the command line or in a script. For more information, see "Releases."

Editing a release

{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.releases %} 3. On the right side of the page, next to the release you want to edit, click Edit release. 4. Edit the details for the release in the form, then click Update release.

Deleting a release

You must remove all binary files attached to a release before you can delete a release.

{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.releases %} 3. Click the name of the release you wish to delete. 4. In the upper-right corner of the page, click Delete. 5. Click Delete this release.