Skip to content

GitHub App

Release Drafter

GitHub App

Release Drafter

Drafts your next release notes as pull requests are merged into master. Open source and built with Probot.


  1. Install the Release Drafter GitHub App into the repositories you wish to automatically create releases in.
  2. Add a .github/release-drafter.yml configuration file to each repository.


For example, take the following .github/release-drafter.yml file in a repository:

template: |
  ## What’s Changed


As pull requests are merged, a draft release is kept up-to-date listing the changes, ready to publish when you’re ready:

Screenshot of generated draft release

See the readme for full documentation of all the options.

⚠️ Installation Permissions

Release Drafter requires full write, because GitHub does not offer a limited scope for only writing releases. Don't install Release Drafter to your entire GitHub account — only add the repositories you want to draft releases on.


Release Drafter is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

Report abuse