Inline notice

v4.0

An inline notice is a contextual message tied to a single element, like a tile or row item, used for field-level guidance, reminders, or validation.

  • CSS
  • Marko
  • React

Anatomy

An inline confirmation alert notice. Number 1 points to the title. Number 2 points to the icon. Number 3 points to the action. Number 4 points to the body. Number 5 points to the close/dismiss.
  1. Title
  2. Icon
  3. Button
  4. Body
  5. Close/dismiss

Properties

Title

A bolded title is optional. Title copy is specific and scannable, which quickly summarizes the purpose of the notice.

Lead with the most important information—what went wrong, what happened, or what users need to do. Don’t add long explanations or include multiple actions. Keep headlines contextual to the information or action related to the component you’re referencing.

  • Use sentence case
  • No ending punctuation
  • Keep to 1 line and don’t repeat the body text
  • Max character count: 60
A mobile screen with an information inline notice. “Title” points to “Reactivate your account”.

Body

Required. The body provides the context or detail users need to understand the notice and act on it, if needed.

For actionable notices, tell the user what to do next. Don't repeat nearby content.

  • Use sentence case
  • Use ending punctuation
  • Use the active voice
  • Avoid repeating the title
  • Keep to 1-2 lines
  • Only one text link (optional)
A mobile screen with an information inline notice. “Body” points to “Fill out a few more details to unlock your ability to list items.”

Dismiss

Alert notices can include a dismiss button that removes the notice from the page layout. This is helpful for general or supplemental information provided by the notice.

A mobile screen with an information inline notice. “Close/dismiss” points to an “x” close icon.

Actionable

Alert notices can include a dismiss button that removes the notice from the page layout. This is helpful for general or supplemental information provided by the notice.

Link button

Link buttons provide a clear next step for users to resolve or engage with the notice. Make the verbs in the title and button correspond, and tell users what will happen when they interact.

  • Use sentence case
  • No ending punctuation
  • Use a [verb] [noun] or [verb] [article] [noun] pattern
  • Aim for 4 words or fewer

See Button text for more guidance.

A mobile screen with an information inline notice. “Button” points to the link button “Update account details”.

Semantic

All alert notices are semantic. The available options are information, attention, confirmation, warning, and neutral. Get writing tips, and view more details for each type on the alert notice overview page.

The four variants of inline notices including information, attention, confirmation, and general.

Behavior

Placement

Inline notices appear on load as part of the page layout and are inset. Content shifts to fill the space when an inline notice is dismissed. Inline notices should always be dismissible or resolvable, not a permanent part of a design.

An information inline notice in the middle of page content. The inline notice states a sales report is ready to export with a button to view the report.

Overflow

All text content will wrap if wider than the container. Avoid wrapping for titles and button titles where possible.

An information inline notice with two lines of body copy. It does not have a title, action button, or dismiss.

Layout

The button is always stacked below the content for inline notices. This applies to both small and large screens.

Two information inline notices. One is wide and one is narrow. Both have the action button below the content.

Screen sizes

Small

On small screens, inline notices are positioned next to the related elements, with the button placed below the main content.

A mobile screen with an information inline notice between sections of content. It has two lines of text and a button.

Large

On large screens, inline notices are positioned beside their related elements. If a button is included, it is placed below the main content. Unlike page and section notices, which can include a right-aligned button, inline notices do not have this option.

A large desktop screen with an information inline notice below a section title about Ads performance. It describes how metrics are reported and only contains a single line of body text.

Best practices

Inline proximity

Do keep inline notices close to and focused on their target element.

A visual graphic showing an inline notice below a group of content.

Don’t use inline notices for sections, page-level content, or attention account information. Use a section or page notice notice instead.

A visual graphic showing an inline notice above a group of content at the very top of a page.

Content

Do keep body copy in regular weight to maintain enough visual separation from the action.

An information inline notice with regular-weight body text.

Don’t use bold weight for the body copy. The button becomes more difficult to discern from the main content.

An information inline notice with bold-weight body text.

Stacking

Do show one inline notice at a time and replace it with the next priority inline notice after the user dismisses or addresses it.

A single inline notice.

Avoid stacking inline notices. Stacked inline notices can quickly become overwhelming.

Three variants of inline notices stacked on top of each other.

Specs

Specs for a wide and narrow inline notice. Both use 16px icons with 12px of space between the icon and content area. 16px is between the body text and link button. 12px of minimum space is between the content area and close/dismiss button. The close button is 16px.