Limit a changelog entry to one or more user segments so only those users can see it. This is useful for beta features, plan-specific updates, or announcements meant for certain customers.
Changelog audiences are available on the Pro and Business plans.
Limit an entry to a segment
Create or edit a changelog entry.
In the left sidebar, below Labels, open the Audience dropdown. It's set to Everyone by default.
Select one or more segments. Admins with the Manage user segmentation permission can click Add new segment to create one without leaving the entry.
Publish or save the entry.
A user who's in any of the selected segments can see the entry.
You can add, change, or remove the audience of a published entry at any time. The change applies right away. Audiences are set one entry at a time; there's no bulk edit.
Who can see a limited entry
Users in the selected segments who are logged in. Canny checks each user against the segment's rules using the user and company data you've sent to Canny, for example through Identify, SSO, or an integration.
Your team. Admins always see every entry. Limited entries show their segments as badges.
Logged-out visitors only see entries visible to everyone. If they'd otherwise see no entries, or they open a link to an entry they can't view, they're prompted to log in.
Segment rules are checked every time someone views the changelog. If you edit a segment, entries limited to it update right away.
Filter the changelog by audience
In the Changelog tab, use the Visible to filter (below Labels in the filters sidebar) and choose a segment. You'll see the entries visible to everyone plus the entries limited to that segment.
Things to note
Emails: when you publish a limited entry with Notify subscribers selected, only subscribers in its segments (and your team) are emailed. Editing a published entry never sends emails, so users added to its audience later aren't notified. See Changelog emails.
Widget: the widget shows each user only the entries they can see. The red notification dot only appears for new entries visible to everyone.
RSS: your changelog's RSS feed only includes entries visible to everyone.
API, webhooks, and exports include each entry's audience as read-only. Audiences can only be set in Canny, not through the API. To import entries with an audience, create them as drafts through the API, set the audience in Canny, then publish them with the API's change-status endpoint.
Users in several segments: segments are checked independently, so one user can match many. Send separate true/false attributes (e.g.
betaProgram,enterprise) and use is true in each segment rather than combining several values in one attribute.Linked feedback: users who can't see an entry won't be linked to it from related feedback.
Deleting segments: you can't delete a segment while any changelog entry uses it, including drafts. Remove it from those entries first.
Changelog privacy: if your whole changelog is private, users need access to the changelog and need to be in the entry's segments.
No audience required: entries default to Everyone. Check for segment badges before publishing; an entry without one is visible to everyone who can see your changelog.

