Also known as:
BannerConfirmationAcknowledgementMessageAlert

Inline Notification

An inline notification is a message object that presents timely information within content areas as close as possible to the thing that it’s about.

AnchorNeed to know

  • An inline notification is a message object that presents timely information within content areas as close as possible to the thing that it’s about.

Visuals

UI Kit

Examples

Informative

E.g. Blank select options These won’t be shown. Add select option text.

Cautionary

E.g. No select options Without select options, this question won’t be shown. Add an option.

Negative

E.g. Meaning changed We prevent significant changes to the meaning of questions in a live survey. To make this change, contact support.

Options

  • Modes:

    • Persistent
    • Dismissible
  • Lines:

    • Single-line: inline/adjacent heading and body
    • Multi-line: stacked heading and body

Copy guidelines

The key to a good inline notification is conciseness and clarity. Here are some language rules:

Give it a descriptive title

Keep the title short but descriptive. Describe exactly what has happened or what needs to happen.

Do:
  • Do
    Data imported successfully
  • Do
    Errors found in your employee data
Don't:
  • Don't
    Success
  • Don't
    Critical error.

Include an explanatory body

Explain the title further but keep it to one to two sentences maximum. Include links to supporting documentation or next actions. If the notification is dismissible, don’t include information that the user would need to perform crucial actions.

Do:
  • Do
    Survey invitations have been scheduled. 10 participants will receive their survey invitations at 9:00AM EST on 10 March 2020.
  • Do
    Errors found in your employee data. For your survey to run smoothly, you must fix these errors and re-import your data.
Don't:
  • Don't
    Sent! They’ll get their invitations soon.
  • Don't
    Errors found in your employee data. Fix them to proceed.

Guide with a Call-To-Action (CTA)

Make sure you guide the user towards a next step if there are any to be taken. Include a link directly to the next step.

Pay close attention to the context

Make sure you adjust the tone of your writing to fit the specific mood of the notification:

  • Positive notifications - Let the user know that the action they performed was successful. Give them a link to a next step, or an opportunity to view the successful result.
  • Informative notifications - Give the user supplementary information to the content on the page.
  • Cautionary notifications - Warn the user of any side effects of the action they’re about to perform.
  • Negative notifications - Let the user know that an error has occurred, describe the error and how they can fix it. Remember to avoid jargon and tech speak.

Write in sentence case with minimal punctuation.

All inline notifications copy should be in sentence case i.e. the first letter of the first word is capitalized and everything else is in lower case unless it’s a proper noun or feature name. Always err on the side of minimal punctuation, so leave out full stops and commas where possible.

To keep in mind

  • Inline Notifications are used for contextual information, including positive feedback or confirmation about an action, warnings about possible issues or show-stopping errors.
  • They are used to provide context in close proximity to a piece of content.
  • They must always follow this anatomy:
    • Title
    • Body
    • CTA link
  • Inline notifications can be system or user triggered.
  • Dismissible or persistent:
    • Use Persistent notifications when the information continues to be relevant after the message is shown, e.g. Defining the reporting size on an Insight report
    • Use Dismissible notifications when the information has been acknowledged and the message is no longer relevant, e.g. helpfully updating formatting for user input data.
  • What’s an autohide?
    • TODO: add details

When to use and when not to use

When to use
  • Use an Inline Notification when you are speaking directly to a piece of content and the notification can be positioned close to the content.
  • Use an Inline Notification for highly contextual information.
When not to use
  • When a message applies at a system level or does not apply to a specific piece of content and it needs to alert all users, use Global Notifications.
  • When you are notifying a user of an action they have taken, provide visual feedback with a Toast Notification.
  • When an action is user triggered and you need to inform the user, use a Confirmation Modal with relevant Mood, e.g. Informative Confirmation Modal.

See also

  • Global Notification: A Global Notification is a message object used for system-level notifications that inform the user about system status such as logging in and background processes like data imports.
  • Toast Notification: Toasts appear in the top–right (or top–left in right-to-left languages). It is used immediately after a specific event such as a user action that does not relate to an object on the page. For example, confirmation of deleted items.

External links