{"meta":{"title":"About releases","intro":"You can create a release to package software, along with release notes and links to binary files, for other people to use.","product":"Repositories","breadcrumbs":[{"href":"/en/enterprise-cloud@latest/repositories","title":"Repositories"},{"href":"/en/enterprise-cloud@latest/repositories/releasing-projects-on-github","title":"Release projects"},{"href":"/en/enterprise-cloud@latest/repositories/releasing-projects-on-github/about-releases","title":"About releases"}],"documentType":"article"},"body":"# About releases\n\nYou can create a release to package software, along with release notes and links to binary files, for other people to use.\n\n## About releases\n\nReleases are deployable software iterations you can package and make available for a wider audience to download and use.\n\nReleases are based on [Git tags](https://git-scm.com/book/en/v2/Git-Basics-Tagging), which mark a specific point in your repository's history. A tag date may be different than a release date since they can be created at different times. For more information about viewing your existing tags, see [Viewing your repository's releases and tags](/en/enterprise-cloud@latest/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags).\n\nYou can receive notifications when new releases are published in a repository without receiving notifications about other updates to the repository. For more information, see [Viewing your subscriptions](/en/enterprise-cloud@latest/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions).\n\nAnyone with read access to a repository can view and compare releases, but only people with write permissions to a repository can manage releases. For more information, see [Managing releases in a repository](/en/enterprise-cloud@latest/repositories/releasing-projects-on-github/managing-releases-in-a-repository).\n\nYou can manually create release notes while managing a release. Alternatively, you can automatically generate release notes from a default template, or customize your own release notes template. For more information, see [Automatically generated release notes](/en/enterprise-cloud@latest/repositories/releasing-projects-on-github/automatically-generated-release-notes).\n\nWhen viewing the details for a release, the creation date for each release asset is shown next to the release asset.\n\nGitHub will automatically include links to download a zip file and a tarball containing the contents of the repository at the point of the tag's creation.\n\nPeople with admin permissions to a repository 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](/en/enterprise-cloud@latest/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository).\n\nIf a release fixes a security vulnerability, you should publish a security advisory in your repository. GitHub reviews each published security advisory and may use it to send Dependabot alerts to affected repositories. For more information, see [Repository security advisories](/en/enterprise-cloud@latest/code-security/concepts/vulnerability-reporting-and-management/repository-security-advisories).\n\nYou can view the **Dependents** tab of the dependency graph to see which repositories and packages depend on code in your repository, and may therefore be affected by a new release. For more information, see [Dependency graph](/en/enterprise-cloud@latest/code-security/concepts/supply-chain-security/dependency-graph).\n\nYou can also use the Releases API to gather information, such as the number of times people download a release asset. For more information, see [REST API endpoints for releases and release assets](/en/enterprise-cloud@latest/rest/releases).\n\n## Storage and bandwidth quotas\n\nUp to 1000 release assets may be associated with a single release. Each file included in a release must be under 2 GiB. There is no limit on the total size of a release, nor bandwidth usage."}