Join us for office hours !

Release Drafter

Drafts your next release notes as pull requests are merged into master.
Screenshot of Release Drafter app






November 20, 2018

Used By

gorilla reactiveui concourse abraham probot benbalter dotnet testcontainers idehub EasyEngine


  1. Install the Release Drafter GitHub App into the repositories you wish to 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.

Configuration options

You can configure Release Drafter using the following key in your .github/release-drafter.yml file:

Key Required Description
template Required The template for the body of the draft release. Use template variables to insert values.
change-template Optional The template to use for each merged pull request. Use change template variables to insert values. Default: * $TITLE ($NUMBER) @$AUTHOR
no-changes-template Optional The template to use for when there’s no changes. Default: * No changes
branches Optional The branches to listen for configuration updates to .github/release-drafter.yml and for merge commits. Useful if you want to test the app on a pull request branch. Default is the repository’s default branch.

Release Drafter also supports Probot Config, if you want to store your configuration files in a central repository. This allows you to share configurations between projects, and create a organization-wide configuration file by creating a repository named .github and file named release-drafter.yml.

Template variables

You can use any of the following variables in your template:

Variable Description
$CHANGES The markdown list of pull requests that have been merged.
$CONTRIBUTORS A comma separated list of contributors to this release (pull request authors, commit authors, and commit committers).
$PREVIOUS_TAG The previous releases’s tag.

Change Template variables

You can use any of the following variables in change-template:

Variable Description
$NUMBER The number of the pull request, e.g. 42
$TITLE The title of the pull request, e.g. Add alien technology
$AUTHOR The pull request author’s username, e.g. gracehopper

Get occasional updates on new apps & features.


with by @bkeepers

Code licensed ISC Docs licensed CC-BY-4.0