What This Workflow Does
This automation solves the tedious manual process of compiling GitHub release notes by automatically generating structured changelogs from merged pull requests and notifying your team in Slack. It eliminates hours of copy-pasting PR details while ensuring consistent, well-formatted release documentation.
The workflow intelligently groups PRs by their labels (features, bugs, docs), includes author attribution, and creates draft releases for maintainer review before publishing. The Slack notification provides immediate visibility with direct links to the GitHub release.
How It Works
1. Trigger the workflow
The process starts when you provide the repository name, owner, and target branch through a simple form interface.
2. Fetch latest Git tag
The workflow identifies the most recent semantic version tag to determine which changes need documentation.
3. Collect merged PRs
It queries GitHub's API for all pull requests merged since the last tag, filtering by your specified branch.
4. Organize and format
PRs are grouped by their labels and transformed into clean markdown with proper headings and section organization.
5. Create draft release
A draft GitHub release is created with the generated notes, ready for maintainer review before publishing.
6. Notify team in Slack
A formatted message is sent to your specified Slack channel with release details and direct links.
Who This Is For
This automation is ideal for:
- Engineering teams managing frequent software releases
- Open source maintainers wanting professional changelogs
- DevOps engineers streamlining release processes
- Technical writers documenting product changes
- Teams using semantic versioning and GitHub flow
What You'll Need
- A GitHub repository with semantic version tags
- GitHub personal access token with repo permissions
- Slack workspace with webhook URL or OAuth access
- PRs labeled consistently (feature/bug/docs/etc.)
- n8n instance (cloud or self-hosted)
Pro tip: Use GitHub's saved replies feature to create templates for common release note sections that this workflow can incorporate automatically.
Quick Setup Guide
- Download and import the JSON template into your n8n instance
- Configure GitHub and Slack credentials in n8n
- Map your PR labels to release note sections in the config node
- Test with a repository that has several merged PRs
- Customize the Slack message format if needed
- Schedule regular runs or trigger manually before releases
Key Benefits
Save 2-3 hours per release by eliminating manual note compilation and formatting work.
Reduce human errors with consistent, automatically generated changelogs that include all relevant PRs.
Improve team visibility through instant Slack notifications with direct links to draft releases.
Professional documentation with standardized formatting that follows best practices.
Flexible customization to match your exact release workflow and notification needs.