How-To2026-10-302 min read

Configure GitHub Release Notes Categories

Configure generated release-note categories and exclusions in the repository release configuration. Generated notes summarize merged pull requests; editorial review still determines whether the release explanation is useful and complete.

Step-by-step guide

01

Check access and scope

You need write access and maintained pull-request labels. Review the current configuration format in GitHub documentation before committing changes.

02

Audit pull-request labels

Review labels on representative merged pull requests.

03

Configure release YAML

Create .github/release.yml with the following minimal configuration. Replace bug, enhancement and ignore-for-release with your actual pull-request labels; an excluded label removes the pull request from generated notes.

changelog:
  exclude:
    labels:
      - ignore-for-release
  categories:
    - title: Fixes
      labels:
        - bug
    - title: Improvements
      labels:
        - enhancement
    - title: Other changes
      labels:
        - "*"
  • Worked example: Group fixes and improvements separately, and exclude internal maintenance only when that omission will not hide a user-visible change. Explain migration requirements outside the generated pull-request list.
04

Include uncategorized changes

Keep the quoted "*" catch-all last so pull requests that match no earlier category appear under Other changes. Review that category for missing labels and user-visible changes.

05

Generate draft notes

Open Releases > Draft a new release, choose the intended tag and explicitly select the Previous tag. Click Generate release notes and save the draft while reviewing categories and omissions.

06

Review omissions and context

Review omitted work and add reader-facing context manually.

07

Verify the result

The draft notes include all intended changes and no unsupported promise of automatic completeness.

Common mistakes

Check the handoff edge case

A missing catch-all category can leave unexpected changes unexamined. Inspect uncategorized work during release preparation.

Sources and verification

Based on product documentation checked on 2026-10-24. This is a documentation-based guide, not a hands-on benchmark. Features and availability can change.

Frequently asked questions

Spend less time on setup, more on decisions

Vantage connects your tools and generates specs grounded in real data. Free to start.

Spec to tickets

Working in GitHub? Turn your spec into dependency-ordered tickets.

Paste the feature or spec. Vantage pulls out the requirements and breaks them into tickets, ordered by what blocks what, ready to groom with your team.

0 / 8,000

Where do your tickets live? (optional)

How this works

  1. We save what you typed. No AI runs on this page.
  2. You create a free account.
  3. Vantage builds a PRD and dependency-ordered tickets from it inside your own workspace.

Why ask for an account? We’re a small team, and a full generation runs a multi-step AI pipeline that costs us real money. So we tie it to a free account instead of running it anonymously. You also get to keep the result and edit it.

Your text is only used to create your project, and it stays private to your account. If you don’t sign up, we delete it after 7 days. Privacy policy

Free to start. No credit card required.

Related reading