Create and Manage Announcements
Publish in-app banners and popups, target them, and review announcement performance.
Use Announcements when a message should appear in the app as a banner or popup and may need impressions, clicks, and dismissals tracked.
Before you begin
You need:
- The
notifications:managepermission. - The announcement title or body.
- Whether the announcement should be a banner or popup.
- Any target routes, roles, start dates, or end dates.
- Any CTA label, CTA URL, or popup image.
Leave targeting empty when the announcement should apply everywhere and to all roles.
Create and target an announcement
Create an announcement
- Open Settings > Features > Notifications.
- Open Announcements.
- Select New announcement.
- Choose the Kind:
- Banner (top of page).
- Popup dialog.
- Choose the Variant:
info.success.warning.urgent.
- Optionally enter a title.
- Enter the body.
- For popups, optionally add an image URL or select an image from the media library.
- Optionally add a CTA label and CTA URL.
- Optionally enter target routes.
- Optionally select target roles.
- Optionally set start and end dates.
- For popups, choose a trigger.
- Confirm whether the announcement is enabled.
- For banners, choose whether users can dismiss it.
- Save.
Target routes and roles
Target routes use one SQL LIKE pattern per line.
Examples:
/dashboard
/courses/%Target roles are optional. If no roles are selected, the announcement applies to all roles.
Popup triggers are:
- First login only.
- Every login session.
- On route visit.
Manage and review announcements
Manage announcements
The announcement list shows:
- Kind.
- Variant.
- Disabled status, when disabled.
- Popup trigger, when relevant.
- Impression count.
- CTA click count.
- Dismissal count.
- Title and body preview.
Use the edit action to update an announcement. Use delete only when the announcement should be removed. The delete action asks for confirmation.
Review announcement performance
The lower part of the Announcements tab shows performance totals and a table for each announcement.
Review:
- Impressions.
- CTA clicks.
- Dismissals.
- Kind.
- Variant.
- Title or body preview.
Use this when you need to know whether users are seeing, clicking, or dismissing an announcement.
Verify success
The announcement is working when:
- It appears only on the intended routes.
- It appears only for the intended roles.
- Start and end dates match the intended window.
- Popup behavior matches the selected trigger.
- Performance totals update after users see, click, or dismiss it.
Troubleshooting
Check whether the announcement is enabled, whether start and end times allow it to show, whether route patterns match the page, and whether target roles include the current user. For popups, also check the selected popup trigger.
Review the target route patterns. Leave the field empty only when the announcement should appear everywhere.
Compare impressions, CTA clicks, and dismissals. Low clicks may mean users saw the announcement but did not need the CTA.