Skip to content
Components

CalloutWarning: Draft

Capture the attention of users and provide them with important feedback or information that relates to an entire page or page section.

Keep it purposeful and relevant

Every callout competes for the user’s attention, so every word must earn its place.

Only show information that is timely, relevant, and genuinely useful to the task at hand. Don’t interrupt active workflows unless it’s critical to do so.

If it doesn’t help the user move forward or make sense of something, it’s clutter.

Information:
Your card expires on 22 October. A new one will be issued automatically.
Information:
Important notice: your card is approaching its expiry date. When this happens, your card will unfortunately stop working. We’ll issue a replacement as soon as possible.

Match the tone to the moment

Tone should reflect the situation — calm, clear, and appropriate to the message.

Whether it’s good news, a warning, or an error, write as if you’re speaking to a capable adult.

Use plain language that feels natural and respectful. Avoid sounding alarmist, accusatory, or patronising.

Warning:
No spending limits have been set for this employee. Add limits
Warning:
Oops! You forgot to add spending limits for this employee. A small mistake like this could end up costing your company thousands. Add limits

Help the user move forward

Be specific about what’s happening and what the user can do next.

Avoid jargon, technical codes, and vague phrasing. Instead, use simple, direct language that tells users exactly what’s wrong (or right) and how to respond.

Always include a clear next step when possible — reassurance through clarity beats reassurance through tone.

Error:
Connection could not be established. Check your Xero account permissions and try again.
Error:
Integration failed: Connection not authorised. Please review Xero account permissions and verify authentication tokens before reinitiating the connection. Contact support if issues persist.

Don’t overdo it

Not every message deserves a callout. Too many can make the experience feel noisy, patronising, or micromanaged.

Use them only when they genuinely add clarity or prevent confusion. If users feel constantly interrupted or nudged, even well-written messages start to lose credibility.

Aim for quiet confidence — say less, but make it count.

New:
Map your chart of accounts to make expense categorisation automatic. Get started
New:
Create names for your expense categories, select the relevant account codes, then customise the icon and colours to optimise your categorisation workflow. Get started
Didn't find what you were looking for?
Edit this page
This page is a draft. Its content is likely to change.