GitHub Releases Alternative for Customer Changelogs
GitHub Releases is built for engineers. A customer-facing changelog is built for users. Herald reads your PRs to draft the changelog AND publishes back to GitHub Releases — so you don't have to choose.
GitHub Releases for engineers. Herald for your users.
GitHub Releases is great at what it does: a versioned, tagged, API-accessible release log for engineers and integrators. It's invisible to the people who actually use your product. Herald reads from your repo to draft the customer-facing changelog AND publishes back to GitHub Releases — so the same release lands in both places.
Free 14-day trial · No credit card · One publish, two surfaces
GitHub Releases and Herald aren't really competitors — they target different readers. GitHub Releases is free and built for developers watching the repo; Herald, from $16/mo, turns the same releases into a branded changelog page, an in-app widget, and email for your end users. Because Herald can publish back to GitHub Releases, most teams run both rather than choosing one.
Two audiences, two surfaces
↓
GitHub Releases serves engineers
Discoverable on the repo. Tagged to a git ref. API-accessible to Dependabot, Renovate, and every release-watching CI script. If your audience is other engineers consuming your library or API, GitHub Releases alone is enough. You probably don't need Herald.
👤
Your users need something else
A SaaS product user is not going to navigate to your GitHub repo and click Releases. They want a clean changelog page on your own domain, an in-product widget with an unread badge, and an email when something ships. None of that is on GitHub Releases.
↔
Herald does both — bidirectionally
Connect your repo. Herald drafts the customer-facing release from your PRs (with AI in three source modes). You review and publish — and the same release publishes back to GitHub Releases with optional 'Posted with Herald' attribution. One source of truth, two surfaces, zero copy-paste. (Team+)
Herald vs GitHub Releases — side by side
Feature
Herald
GitHub Releases
Free plan
—
Free (built into GitHub)
Starting paid price
$16/mo (Solo)
Free
Reads merged PRs
Included (3 source modes)
Included (auto-generate notes)
AI draft from PRs
Included (all paid)
— (template, not AI)
Customer-facing changelog page
Hosted on your domain
On github.com only
Embeddable in-app widget
—
Email subscribers
—
Custom domain
Team+
—
Branded for your product
— (GitHub-branded only)
User segmentation / groups
Team+
—
Analytics on release reads / clicks
Team+
— (only stars/downloads)
SEO indexable for product queries
Yes (your domain)
Limited (github.com pages)
Publish back to GitHub Releases
Team+
N/A
Multi-repo aggregation (parent/child)
Team+
— (one repo per release stream)
Scheduled publishing with timezone
—
The bidirectional GitHub flow
1. Connect your repo
Paste the repo path (public) or install the Herald GitHub App (private repos, Team+). Herald gets read access to your merged PRs and write access to publish back to Releases.
2. Draft from your code
Open Releases → New Release. Pick a source mode: branch-to-branch diff, release/tag diff, or merged PRs in a time range. AI auto-curates what belongs and writes the entries.
3. Edit for your users
The Herald editor is where the voice shifts from engineer to user. Reorder items, cut internal-only changes, rewrite anything too technical. Same source of truth, different audience.
4. Publish to both surfaces
Hit Publish. Your hosted changelog page updates, the widget badge increments, subscribers get an email — AND the release appears on your GitHub Releases page too, with an optional 'Posted with Herald' footer. (Team+)
When GitHub Releases alone is enough
If your audience is engineers — library maintainers, SDK authors, API providers whose users are all in code — GitHub Releases is the right tool and Herald is overkill. The auto-generated release notes between two tags work, downstream tools watch your Releases for new versions, and adding a separate customer-facing changelog would be marketing surface area you don't need. Stay with GitHub Releases.
When you need both
If your product is a SaaS, mobile app, dashboard, or anything used by humans who aren't in your code, you need a customer-facing changelog AND you probably want your engineering team to keep using GitHub Releases. That's the gap Herald closes. The release happens once, in Herald, with all the AI-drafting and user-focused editing tools — and lands in both places.
Is Herald right for you?
Use Herald if you...
Ship a product used by humans who are not your engineering team
Want a customer-facing changelog page on your own domain, indexed for your product-name queries
Want an in-product widget with unread counts and read tracking
Want subscribers and email notifications when you ship
Want to keep using GitHub Releases AND have one publish action update both surfaces
Have multiple repos that need to roll up into one customer-facing changelog
Stick with GitHub Releases if you...
Your audience is entirely other engineers, contributors, or downstream library consumers
You only need a versioned release log that downstream automation can watch
You don't have a customer-facing product, just a library or SDK
You're shipping fewer than a few releases a year and a manual GitHub Release is enough
Already on GitHub Releases? Keep going. Add Herald on top.
There's no migration. Your existing GitHub Releases stay where they are — Herald doesn't touch your history. New releases get drafted in Herald from your merged PRs and publish forward to both your customer-facing changelog AND your GitHub Releases page going forward.
Connect your repo to Herald (public: paste the path; private: install the GitHub App).
Pick a draft source — last 30 days of merged PRs is a fine starting point.
Review the AI draft, edit for your users, publish.
Enable "Publish on GitHub" in Settings → Integrations → GitHub to push future releases back to GitHub Releases too.
Old GitHub Releases stay in place. New releases get authored once in Herald and land in both surfaces.
Common questions
Will using Herald mean maintaining two changelogs?
No — that’s the point of publish-back. Write the release once in Herald and it can sync to GitHub Releases, so the engineer-facing log and the customer-facing changelog stay current from one source instead of being maintained separately. (Team+)
Do I lose GitHub’s auto-generated release notes if I use Herald?
No. GitHub keeps generating notes for the people watching your repo, and Herald reads your PRs (and can read existing Releases) as a source to write a version for your users. You keep both — one for integrators, one for customers.
Is a GitHub Releases page good for SEO?
It lives on github.com, so any ranking benefit accrues to GitHub, not your domain. A Herald changelog sits on your own domain, so it's indexable for your product's queries and builds your site's authority instead of GitHub's.
Stop maintaining two changelogs.
Herald drafts the customer-facing release from your PRs and publishes back to GitHub Releases. One source of truth, two surfaces. Free 14-day trial, no credit card.