Changelog

The changelog is how you announce what shipped and close the loop with the people who asked for it. Entries appear on your public changelog page and in the widget, and subscribers can get them by email. This is where heedback announces.

Writing an entry

From Changelog in the dashboard, create an entry with a title and a rich body (Markdown). Entries start as drafts — invisible to the public — until you publish them. You can attach labels (e.g. New, Fix, Improved) to help readers scan.

Audience targeting (Team)

Some announcements only matter to some of your users. On any entry — draft or published — open the Audience row and add rules against the traits you send with identify(): plan equals pro, beta is set, and so on. All rules must match (there's no "any of"), and you can set up to ten per entry. An entry with no rules is shown to everyone, which is how every existing entry behaves.

Targeted entries are widget-only. Because the rules are evaluated against a user's traits, they can only apply where those traits exist — so an entry with at least one rule is left out of your public changelog page, the public API, and the email digest entirely, rather than being shown to people we can't identify. Entries you've narrowed carry a Targeted badge in the dashboard so you can tell at a glance.

Scheduling

Instead of publishing immediately, set a future publish time and heedback will release the entry automatically when it's due. Useful for lining up an announcement with a launch without being at your desk.

Email digests & subscribers

Users can subscribe to your changelog from the public page. Subscriptions are double-opt-in (confirm by email) and every message includes an unsubscribe link, so the list stays clean and compliant. heedback batches new entries into a workspace-wide digest so subscribers get a tidy roundup rather than a message per entry.

Where it shows

• Public changelog page under your workspace URL.
• Widget — a changelog tab your users can open from your own site.
• Email — to confirmed subscribers.

An entry with audience rules appears in the widget only, and only to users whose traits match — the page, the API and the digest leave it out.

Closing the loop

Announcing a shipped post is the pay-off of the whole flow: an idea from a board, tracked on the roadmap, lands here — and you can then survey users to measure how it went.