release-drafter

Auto-draft GitHub releases from merged PRs, grouped by label.

What it does

Collects merged PRs since the last release, groups them by label (features, bugs, other), and creates a draft release with clean markdown notes.

Usage

name: Draft Release
on:
  push:
    branches: [main]

jobs:
  draft:
    runs-on: ubuntu-latest
    steps:
      - uses: ollieb89/release-drafter@v1.0.0
        with:
          token: ${{ secrets.GITHUB_TOKEN }}

Inputs

Input	Required	Default	Description
token	✅	—	GitHub token
tag-prefix	❌	v	Tag prefix
draft	❌	true	Create as draft

Label mapping

Label	Section
enhancement, feature, feat	🚀 Features
bug, fix, bugfix	🐛 Bug Fixes
anything else	🔧 Other Changes

Keywords

github-actions, release-drafter, changelog, automation, github, developer-tools, ci-cd

License

MIT © 2026 ollieb89