new·The score now tells you which way it movedA brain's exam only ever grows: its own material writes questions, and so does every question a real caller asked and did not get answered. The score is a percentage over that growing set, so a brain that learned more could post a smaller number — and this week three did. One of them answered two MORE questions than the week before and showed eighteen points less. Printed as a single percentage, that reads as decline to a reader and as punishment to anyone who contributes material.all news →
mozg.beta
Sign in

Shopify Polaris · all subjects

deprecated-components

72 notes in this subject, read out of this brain and free to use. This is page 2 of 2.

Toast message word limit

Toast messages must not go over 3 words.

Toast message content pattern

Toast messages should be written in the pattern of: noun + verb. Examples: Product updated, Collection added, Customer updated, Internet disconnected, Connection timed out.

Toast message anti-patterns

Toast messages should not use: 'No internet connection', 'Can't charge negative tax rates', 'Your online store has a maximum of 20 themes. Delete unused themes to add more.', 'Your product has been successfully updated', 'We were unable to save the customer', 'Your Order was Archived Today', 'Discount: Saved successfully'.

Toast action label examples

Toast action labels should be kept short, preferably 1 verb. Good examples: Undo, Change, Edit, View, Retry.

Toast action label anti-patterns

Toast action labels should not use: OK, Got it, Cancel product, Continue to collection, Dismiss.

Toast action availability rule

Only include an action in toast if the same action is available elsewhere on the page. For example, offer [Reload] only if merchants can reload the section another way, or [Undo] only if they can retrieve the deleted item elsewhere.

Toast with action duration requirement

Toast with an action should be used with a duration of at least 10,000 milliseconds for accessibility.

Toast accessibility challenges

Avoid using toast for critical information that merchants need to act on immediately. Toast might be difficult for merchants with low vision or low dexterity to access because it disappears automatically, can't be easily accessed with the keyboard, and might appear outside the proximity of the merchant's current focus.

Toast default duration

The default duration of a toast message is 5000 milliseconds.

Toast use cases

Toast should be used for success messages and only for non-critical errors that are relevant in the moment and can be explained in 3 words, such as 'Internet disconnected'. Avoid using toast for error messages; use a banner instead to prominently inform merchants about persistent errors.

Toast accessibility implementation

The content of the toast component is implemented as an ARIA live region using aria-live="assertive". When the toast appears, screen readers will interrupt any announcement a screen reader is currently making.

Loading component is internal only

The loading component is marked as internal only.

Give your agent this brain