Announcements

Announcements let you push proactive messages to users without them opening the widget. Each announcement is sourced from a synced Notion page.

Display types

Choose the type when creating an announcement in the dashboard.

Targeting

Announcements support four targeting axes:

WHERE — which pages

Match by the page URL or the referrer, using one or more patterns (wildcards allowed). Leave unset to show on all pages.

• https://app.example.com/* — any page in your app
• https://app.example.com/dashboard — only the dashboard

WHEN — triggers

Add one or more triggers; the announcement fires when any is satisfied. With no trigger it shows on load.

• On load — as soon as the page loads (default).
• Delay — N seconds after load.
• Scroll depth — after the user scrolls N% of the page.
• Time on page — after N seconds on the page.
• Page views — after the user has viewed N pages.
• Repeat views — on the user's Nth qualifying view.
• URL reached — when the user hits one of up to 5 URL patterns.

WHO — audience

Show to everyone, or a selected audience matched on customer properties passed via identify. Each clause is a property + an operator — is, is not, or is not set — and clauses combine with AND or OR.

• plan is free
• role is-not admin

Users who aren't identified (or don't match) won't see it.

FREQUENCY — how often

• Once — once per user, ever.
• Every — on every qualifying load.
• Until dismissed — keep showing until the user dismisses it.
• Interval — repeat every N days.

Schedule

Optionally set a start and end time — the announcement is only active within that window, on top of the targeting rules above.

CTA button

Each announcement can include an optional call-to-action button. Choose its action:

• Open article — open a Docs article in the widget.
• See all updates — open the Product Updates surface.
• Custom link — open a URL you specify.
• Dismiss only — just close the announcement.

Triggering manually

You can trigger an announcement from JavaScript — useful for event-driven flows:

// Trigger by announcement id
LumioWidget('announce', 'ANNOUNCEMENT_ID')

// With options
LumioWidget('announce', 'ANNOUNCEMENT_ID', { delay: 2000, force: true })

• delay — milliseconds to wait before showing.
• force — override frequency limits and show regardless of prior views.

Content

The announcement body is a synced Notion page — the same sync flow as updates and docs. Edit in Notion, sync in the dashboard, and the new content is live.