Announcements

Announcements let you push messages to your users directly inside your application through the embeddable widget. Use them to highlight new features, share important notices, or promote time-sensitive offers.

Display modes

Announcements support two display modes:

• Badge — A small notification indicator on the widget that draws attention without interrupting the user experience. Users click to view the announcement.
• Banner — A more prominent display that appears within the widget interface, suitable for high-priority messages.

Creating announcements

Each announcement includes the following fields:

• Title — The headline of the announcement.
• Body — The full message content.
• CTA button — An optional call-to-action button with a custom label and URL. Use this to link users to a changelog entry, documentation page, upgrade flow, or any external resource.
• Badge color — A custom color for the badge display mode, so you can match your branding or signal urgency.

Time-based visibility

Announcements support scheduled visibility with two optional fields:

• Starts at — The date and time when the announcement becomes visible. If not set, the announcement is visible immediately.
• Expires at — The date and time when the announcement is automatically hidden. If not set, the announcement remains visible indefinitely.

This lets you set up announcements ahead of time and have them appear and disappear on schedule without manual intervention.

Scope

Announcements can be scoped to control where they appear:

• Workspace-wide — The announcement is shown across all sites in your workspace.
• Site-specific — The announcement is shown only on a particular site.

This is useful when an update affects only one product or section of your application.

Dismissal

Users can dismiss announcements they have seen. The dismissal state is persisted locally in the user’s browser, so dismissed announcements will not reappear for that user on that device.