# How to publish a release with generated notes on GitHub

Use this walkthrough to create a new GitHub release, generate release notes automatically, and publish the release. Follow the steps in order if you are doing this for the first time.

## 1. Open the releases page

![Open the releases page](https://turtlescenestore.blob.core.windows.net/screenshots/cf96ab4d-aed4-4e9b-8603-5814476b1f94/demos/f12ef1f8-30b8-46fd-9cfd-aa1a949d377a/pack-1792658651593/article/step-1.jpg)

From the repository homepage, click the latest release tag, shown as v2.3.0 Latest. This opens the releases page, where you can see the current release details.

## 2. Start a new release

![Start a new release](https://turtlescenestore.blob.core.windows.net/screenshots/cf96ab4d-aed4-4e9b-8603-5814476b1f94/demos/f12ef1f8-30b8-46fd-9cfd-aa1a949d377a/pack-1792658651593/article/step-2.jpg)

Click Draft a new release. The release creation form opens, with the tag and title fields filled in.

## 3. Open the tag menu

![Open the tag menu](https://turtlescenestore.blob.core.windows.net/screenshots/cf96ab4d-aed4-4e9b-8603-5814476b1f94/demos/f12ef1f8-30b8-46fd-9cfd-aa1a949d377a/pack-1792658651593/article/step-3.jpg)

Click Select tag. This opens the tag dropdown so you can choose an existing tag or create a new one.

## 4. Create a new tag

![Create a new tag](https://turtlescenestore.blob.core.windows.net/screenshots/cf96ab4d-aed4-4e9b-8603-5814476b1f94/demos/f12ef1f8-30b8-46fd-9cfd-aa1a949d377a/pack-1792658651593/article/step-4.jpg)

In the tag menu, look for v2.4.0. If no matching tag appears, click Create new tag to start defining it.

## 5. Confirm the tag

![Confirm the tag](https://turtlescenestore.blob.core.windows.net/screenshots/cf96ab4d-aed4-4e9b-8603-5814476b1f94/demos/f12ef1f8-30b8-46fd-9cfd-aa1a949d377a/pack-1792658651593/article/step-5.jpg)

Click Create to finalize the new v2.4.0 tag. You return to the release form with Tag: v2.4.0 selected.

## 6. Generate release notes

![Generate release notes](https://turtlescenestore.blob.core.windows.net/screenshots/cf96ab4d-aed4-4e9b-8603-5814476b1f94/demos/f12ef1f8-30b8-46fd-9cfd-aa1a949d377a/pack-1792658651593/article/step-6.jpg)

Click Generate release notes. GitHub automatically fills the release notes editor with notes based on merged pull requests.

## 7. Enter the release title

![Enter the release title](https://turtlescenestore.blob.core.windows.net/screenshots/cf96ab4d-aed4-4e9b-8603-5814476b1f94/demos/f12ef1f8-30b8-46fd-9cfd-aa1a949d377a/pack-1792658651593/article/step-7.jpg)

Click in Release title and type the title you want for this release. This updates the release title on the form.

## 8. Add your own release details

![Add your own release details](https://turtlescenestore.blob.core.windows.net/screenshots/cf96ab4d-aed4-4e9b-8603-5814476b1f94/demos/f12ef1f8-30b8-46fd-9cfd-aa1a949d377a/pack-1792658651593/article/step-8.jpg)

Click in Release notes and add your own summary text at the top. Your custom text appears above the generated sections.

## 9. Publish the release

![Publish the release](https://turtlescenestore.blob.core.windows.net/screenshots/cf96ab4d-aed4-4e9b-8603-5814476b1f94/demos/f12ef1f8-30b8-46fd-9cfd-aa1a949d377a/pack-1792658651593/article/step-9.jpg)

Review the form, then click Publish release when everything looks ready. GitHub opens the published release page, where you can see contributors and assets.

Your release is now live, with generated notes and your own summary included.