Spectrum

Version 6.0.0

Coach mark

Coach marks are temporary messages that educate users through new or unfamiliar product experiences. They can be chained into a sequence to form a tour.

Table of contents#

Anatomy
Options
Behaviors
Usage guidelines
Internationalization
Keyboard interactions
Changelog
Design checklist

Anatomy#

Image illustrating through labels the parts of a Coach mark, including its Indicator, Image, Steps, Title, Body, and Buttons including Skip tour and next.

Options#

In a tour#

Coach marks are in a tour when the primary action of one coach mark will lead to the display of another. The "Skip tour" button creates an escape path for the user to avoid having to click through each step.

A step indicator is optional but encouraged. Display of progress should be consistent throughout the tour — either all steps should have this, or none.

With image#

Coach marks can contain images that relate to their content, such as demonstrations of gestures, the UI being used, or illustrations.

Key example showing coach mark in a tour dependent on an action. Title Shared library. Description Your shared library items are available in the Library panel. Add an asset from the library to continue. One quiet button, label Skip tour.

Action dependent#

Coach marks in a tour can be dependent on an action. Unless the tour is skipped, they will persist until the user takes the corresponding action. In this example, the coach mark would disappear once a user opens the panel.

Indicator color#

The coach mark indicator comes in standard (large) and quiet (small), with a light, dark, and blue variant for contrast in different situations.

Behaviors#

Text overflow#

When the title and body text are too long for the available horizontal space, they wrap to form another line. The steps are always shown in full and never wrap or truncate.

Usage guidelines#

Use a consistent width#

Choose a width for your coach marks that is spacious enough to accommodate all of your content. Within a tour that includes many coach marks, keep the width consistent across each one.

Key example showing the correct usage of consistent width coach marks. Two coach marks. First coach mark title Edit, step 1 of 14. Description You can make changes to your post at any time with the Edit tool. One quiet button, label Skip tour. Primary button, label Next. Second coach mark title Undo, step 2 of 14. Description Use the button or type Command+Z to undo the last action you took. One quiet button, label Skip tour. Primary button, label Next.

Key example showing the incorrect usage of consistent width coach marks. Two coach marks. First coach mark title Edit, step 1 of 14. Description You can make changes to your post at any time with the Edit tool. One quiet button, label Skip tour. Primary button, label Next. Second coach mark title Undo, step 2 of 14. Description Use the button or type Command+Z to undo the last action you took. One quiet button, label Skip tour. Primary button, label Next.

Keep titles concise#

Aim for concise titles, and keep complex information in the body text. Titles should be in sentence case. Avoid wrapping if possible.

Key example showing correct usage of a concise title for coach marks. A coach mark message with a body text and the buttons "skip tour" and "next" features the one-word title "undo".

Key example showing incorrect usage of a concise title for coach marks. A coach mark message with a body text and the buttons "skip tour" and "next" features the long title "How to undo your previous action".

Keep body text succinct and informative#

Coach marks are meant to be quick overviews of functionality. Body text should be at least a few words, but no more than a few sentences.

Coach mark copy should be concise, but written in complete sentences and expressing encouragement and usefulness. View the voice and tone guidelines for more information.

Key example showing incorrect usage of a succinct and informative body text. Two coach mark messages with a body text and the buttons "skip tour". The body text in the first message with the text "click to edit." is too short. The body text in the second message is three paragraphs long and therefore not succinct and informative.

Align coach marks with the action being explained#

Coach marks are aligned with their related components in the same way as popovers. Choose a placement that keeps the related component visible on screen.

Key example showing correct usage of alignment and placement for coach marks. A coach mark explaining a play button is aligned above three action buttons ("back, play, forward") and a video timeline.

Key example showing incorrect usage of alignment and placement for coach marks. A coach mark explaining a play button is aligned below three action buttons ("back, play, forward") and aligned above a video timeline, covering the video timeline.

Don't obscure a relevant part of the UI with the coach mark.

Use an indicator to show the source#

Unlike popovers, the UI component a coach mark refers to does not need to take a down state. Use the placement of the coach mark and its indicator atop the component to indicate source.

Key example showing correct usage of an indicator to show the source. An indicator in active state featuring a round border activated a coach mark with a title, body text, steps and two buttons.

Key example showing incorrect usage of an indicator to show the source. An indicator in active state with the look of a square source button activated a coach mark with a title, body text, steps and two buttons. The source button contains a pencil icon and a highlighted active background color.

Using the "Skip tour" button#

The “Skip tour” button should always be a quiet secondary button, even when it’s the only button available in the dialog. Omit this button on the last step of a tour.

Key example showing correct usage of "skip tour" button in a coach mark. In the first coach mark a quiet secondary button"skip tour" is placed next to a primary button "next" with steps in the top right "2 of 14" indicating more tour steps. The second coach mark places a primary button "finish" and no secondary button as the steps in the top right indicate "3 of 3" steps.

Key example showing incorrect usage of "skip tour" button in a coach mark. The primary action buttons "skip tour" and "next" are next to each other in a coach mark with a title, steps and body text.

Don't use inconsistent action names within a tour#

The primary action should be brief and consistent. Use "OK" for a single coach mark. Within a tour, use “Next” for all but the last step, and “Finish” for the last step. Don’t use different primary action names for every step in a tour.

Key example of correct way to use consistent actions in a coach mark tour. First example, a standalone coach mark. Title, Unread notifications. Body, This area shows your unread messages from every channel your follow. Primary action, OK. Second example, 3 coach marks in a tour. First coach mark. Title, Zoom in. Step 1 of 3. Body, Switch to the Zoom tool then click and drag in the canvas to move your camera forward and backward. Primary action, Next. Secondary action, Skip tour. Second coach mark, Title Undo. Step 2 of 3. Body, Use the button or type Command + Z to undo the last action you took. Primary action, Next. Secondary action, Skip tour. Third coach mark, title Export. Step 3 of 3. Body, When you’re ready to share your work, use the Export tool to save a copy of your artboards in many formats. Primary action, Finish. Secondary action, Skip tour.

Key example showing inconsistent action names. Three coach marks with steps, title and body text indicate a three steps tour. The primary button on the first coach mark is label "continue", the button on the second coach mark is label inconstantly "next" and the last coach mark labels the button correctly "finish".

Allow dismissal when a coach mark depends on an action#

When a coach mark is dependent on a user action, it’s OK to remove the primary action button as long as the user still has a way to exit.

On a one-off coach mark, this means that the primary action button should remain as a way to dismiss. In a tour, it’s acceptable to show only the "Skip tour" button.

Key example showing correct usage of a dismissal coach mark. A coach mark waiting for a user action is missing the primary "next" button. Only the secondary quiet button "skip tour" is present with the coach mark title, steps "2 of 14" and a body text.

Key example showing incorrect usage of a dismissal coach mark. A coach mark with a title and body text is missing a dismissal button.

Don't require users to confirm that they've taken an action#

When a coach mark is dependent on a user action, don't force the user to confirm that they've taken that action.

Key example showing incorrect usage of a coach mark confirmation. A coach mark with the primary action button labeled "asset added" forces a dependent user action in order to continue the tour.

Internationalization#

Key example showing a coach mark in the right-to-left language use case. The coach mark indicator is align on the top right of the coach mark and the title and body text are align to the right. The primary action button is align to the left followed by the secondary quiet button.

RTL#

For RTL (right-to-left) languages, the default layout of the coach mark is mirrored. Text is right-aligned while the chevron and the button group are left-aligned.

Keyboard interactions#

Key	Interaction
Tab	Moves focus to the next button inside the popover (last becomes first).
Esc	Exits the current coach mark. If in a tour, proceeds to the next coach mark (does not skip the entire tour).

Changelog#

Date	Number	Notes
Apr 06, 2022	6.0.0	Updated all colors to 6.0.0
Sep 11, 2019	5.1.1	Increased opacity of the animated indicator
Aug 22, 2019	5.1.0	Added text overflow behavior
Apr 19, 2019	5.0.0	This component is now individually versioned (individual versions of existing components start at 5.0.0) Added RTL (right-to-left) guidelines

Design checklist#

All interactive states

Includes all interactive states that are applicable (hover, down, focus, keyboard focus, disabled).

All color themes

Works properly across all four color themes (lightest, light, dark, darkest).

All platform scales

Includes a desktop scale (UWP, macOS, web desktop) and a mobile scale (iOS, Android, web mobile).

Accessible use of color

Color is not used as the only visual means of conveying information (WCAG 2.0 1.4.1).

Accessible contrast for text

Text has a contrast ratio of at least 4.5:1 for small text and at least 3:1 for large text (WCAG 2.0 1.4.3).

Accessible contrast for UI components

Visual information required to identify components and states (except inactive components) has a contrast ratio of at least 3:1 (WCAG 2.1 1.4.11).

Content design

UI language and information design considerations have been incorporated into component design.

Defined options

Includes relevant options (variant, style, size, orientation, optional iconography, decorations, selection, error state, etc.)

Defined behaviors

Includes guidelines for keyboard focus, layout (wrapping, truncation, overflow), animation, interactions, etc.

Usage guidelines

Includes a list of dos and don'ts that highlight best practices and common mistakes.

Writing guidelines

Includes content standards or usage guidelines for how to write or format in-product content for the component.

Internationalization guidelines

Works properly across various locales and includes guidelines for bi-directionality (RTL).

Keyboard interactions

Follows WCAG 2.0 standards for keyboard accessibility guidelines and includes a description of the keyboard interactions.

Design tokens

All design attributes (color, typography, layout, animation, etc.) are available as design tokens.

N/A

UI kit

Includes a downloadable XD file that shows multiple options, states, color themes, and platform scales.

Generated UI kit

Includes a downloadable XD file, generated by code using design tokens defined in Spectrum DNA, and shows multiple options, states, color themes, and platform scales.

In Spectrum for Adobe XD plugin

Component is included in the Spectrum for Adobe XD plugin.

Alert dialog

Color loupe