In-app announcement best practices: formats, targeting and timing
A good in-app announcement has one message, the right format, a clear call to action and the right audience. In JustOneCX you pick a format, set a schedule, choose who sees it and how often, preview it, and publish. This guide walks through each choice.
The settings come from the announcements guide. Advice on what to write is general practice.
What is an in-app announcement?
An announcement is a message you show inside your product: a new feature, a maintenance notice or a promotion. Visitors see it where they already are, so it reaches people who use the product.
Announcements are separate from your public changelog. See how to write a changelog.
How do you create one?
- Open Announcements in the dashboard and create one.
- On the Builder tab, pick a format (modal, slideout, banner or changelog popover) and write the content.
- On the Settings tab, set the Schedule, then under Targeting choose who sees it (everyone, or a segment) and how often. An A/B test section is there too.
- Publish.
Use Preview in the header to click through the announcement before it goes live. Results are on the Results tab.
Which format should you pick?
There are four formats.
| Format | Behaviour | Fits |
|---|---|---|
| Modal | Centre of the screen, asks for attention | Something most people must see |
| Slide-out | A panel at the side | A new feature with a short explanation |
| Banner | Pinned to the top of the page, needs no target element | A notice such as maintenance |
| Changelog popover | Points at your changelog | A summary of what is new |
The banner behaviour is from the docs. The "fits" column is general advice. Use a modal sparingly, since it blocks the page. For small news, a banner or slide-out is less disruptive.
When should it run?
Set the Schedule on the Settings tab. A schedule has a start and an end time, which suits a launch, a maintenance window or a time-limited offer. Match the end time to the end of the event, so a stale message does not stay on screen.
Who should see it?
Under Targeting, choose everyone or a segment. Announcements use the same targeting model as tours and surveys, so you can use segments, conditions and page rules. Read user segmentation for SaaS and the targeting guide.
Good targets are plain. Tell people about a feature they can use. For example, target accounts on the plan that has it, or people who never performed the related event. Leaving targeting empty shows it to everyone, everywhere.
The server applies the audience before content is sent, so people outside it never receive the announcement.
How often should it show?
Set how often under Targeting. A visitor who dismisses an announcement does not see it again. Keep the frequency low so a message does not feel like nagging. One notice per topic is a good rule.
What should the call-to-action button do?
An announcement can have a call-to-action button that opens a link or starts a tour. Pick one action. If the news is a new feature, a button that starts a tour of it lets people try it right away. Read product tour best practices.
Only http and https links are allowed in announcement content. Other link types are removed.
Should you A/B test an announcement?
The A/B test section on the Settings tab is there for this. Test one change at a time, such as the headline or the button text, so you know what caused a difference. Check the Results tab to compare. The docs describe the section but not its detailed behaviour, so open it in the dashboard to see the options.
How do you preview before publishing?
Use Preview in the header. It lets you click through the announcement before it goes live. Check the text, the button and how it looks next to your own page.
Announcements and tours load independently. A problem with one never blocks the other.
How does this relate to the changelog and What's new?
Announcements are messages inside your product. Your public changelog is separate. You write and publish its entries under Roadmap & Changelog > Changelog. Publishing an entry can also create a banner announcement that links to it. See what's new widget for an in-app panel with an unread badge.
Frequently asked questions
Which formats can an announcement use?
Modal, slideout, banner or changelog popover.
Will a visitor see a dismissed announcement again?
No. A visitor who dismisses an announcement does not see it again.
Can the button start a tour?
Yes. An announcement can have a call-to-action button that opens a link or starts a tour.
Can I check an announcement before it goes live?
Yes. Use Preview in the header to click through it before you publish.
See how it works in the live demo.