Components · Notifications

E-Com Toast

An E-Com Toast confirms a shopping action without leaving the page: a product added to the cart, or saved to the wishlist. It has no status color; it speaks in the store’s own black and white.

Tokens, sizes, measurements, states and requirements. Values come from the live token package and from E-Com Toast.

Design Tokens

Resolved from the live token package.

VariantPartTokenValue

Sizes

Dimensions

Tablet is 640 to 768px. The Figma axes are Variant and Breakpoint.

PropertyDesktop (769px+)Tablet (640–768px)Mobile (below 640px)
Width, Add to cart440px440px375px
Width, Informational375px375px375px
Padding24px24px16px
TextName bold 16/18 + text body-md 17/24, 0.32px, at every breakpointsamesame
Buttons32px high, label-sm 14px, 0.56px, padding 6px32px high, label-md 14px, 0.42px, padding 4pxsame as tablet
Informational linkbody-md 17/24, underlined, wraps after the text with 8px / 12px gaps17/2416/22
Gap image to text16px16px16px
Gap content to close12px12px12px
Shadowvar(--shadow-elevation-b-80)samesame

Position

Same as the Toast: fixed in the top-right corner (from the top, full width, on mobile).

BreakpointTopRightWidth
lg (1024px+)40px40px440px or 375px
md (769–1023px)32px32px440px or 375px
sm (640–768px)32px32px440px or 375px
xs (0–639px)00 (left 0)Full viewport width

Measurements

Dimensions

The padding of the Add to cart toast. The numbers are read from the component.

Breakpoint
Add to cart at true size. Change the Breakpoint to see the mobile values.
AttributeDesktop (769px+) and tabletMobile (below 640px)
Padding, Add to cart24px16px
Padding, Informational24px, of which 1px is the edge (23px + 1px)16px, of which 1px is the edge (15px + 1px)
Gap image to text16px16px
Gap content to close12px12px
Above the buttons16px16px
Between the buttons8px8px

Spacing

The same distances as spacing tokens.

PartValue
Padding, tablet and desktopspace-24
Padding, mobilespace-16
Image to textspace-16
Content to closespace-12
Above the buttonsspace-16
Between the buttonsspace-8

Elevation

PartTokenValue
E-Com Toastshadow-elevation-b-80The same shadow as the Toast.

States

Both variants. An E-Com Toast has no hover or disabled state of its own: the buttons, the link and the × have. Its lifecycle is under Motion.

Breakpoint
VariantExample

Typography

ElementTokenMobile and tabletDesktop (769px+)
Product nametitle-sm16/18, bold16/18, bold
Textbody-md17/24, 0.32px17/24, 0.32px
Buttonslabel-md / label-sm14/14, 0.42px14/14, 0.56px
Informational linkbody-md16/2217/24

The text is 17/24 at every breakpoint, as in Figma. This pair is body-md on desktop.


Structure

Elements

ElementClassNotes
Toastecom-toast ecom-toast--cart or --infoAdd to cart or Informational.
Headerecom-toast__header, ecom-toast__image-textImage, text and ×. Add to cart only.
Imageecom-toast__img40×40px, alt="".
Textecom-toast__text, ecom-toast__nameThe name is bold.
Footerecom-toast__footerBlank and Primary buttons, 32px high.
Informationalecom-toast__info-content, ecom-toast__info-textText and optional link.
Closeicon-btn icon-btn--closeAdd icon-btn--close-inverted on Informational.

Types

Two variants: Add to cart and Informational. No status and no emphasis.

Width

440px (Add to cart) or 375px (Informational) from 640px; the full width below.


Motion

PropertyValue
Slide in / outvar(--duration-medium-2) (300ms), var(--ease-decelerate-emphasized) in, var(--ease-accelerate-generic) out
Auto-hide4000ms (same as System Toast)
PositionFixed. Top 40px / right 40px at 1024px+, 32px below, top and full width on mobile

Compare other easing and duration values in the live Motion section on Examples & Guidelines.


Behavior

InputResult
Click ×, click outside, waitExit animation, then removed. Auto-hide after 4 seconds.
Click a button or the linkRuns its action and closes the toast.
TabButtons, link and × take focus with a visible ring.
Inline linkInformational: Inline Link, inverted (white). Underlined when enabled; on hover the underline goes and the color changes.

Accessibility Requirements

TopicRequirement
AnnouncementAnnounced politely through role="status" and aria-live="polite"; focus is not moved (WCAG 4.1.3).
ImageThe product image is decorative: alt="". The name is in the text.
FocusButtons, link and × have a 2px ring, border-focus, on keyboard use (WCAG 2.4.7).
ContrastWhite text on surface-100 in Informational. Link and × use the inverted tokens.
Reduced motionNo slide under prefers-reduced-motion: reduce.