Skip to content

Alert

Contextual feedback messages for success, warning, error, and informational states.

Information

This action will affect all users in your organization.

Variants

Four tones cover the feedback spectrum. Match severity to meaning and always include a specific, actionable message.

VariantPurpose
InfoNeutral announcements, tips, and in-progress updates.
SuccessConfirmation that an action completed successfully.
WarningCaution — something needs attention but is not blocking.
ErrorCritical failure — the user must act. Never auto-dismiss.

Design tokens

TokenValueDescription
background/state/info/subtle
#ecf7ff
Info background
border/state/info
#00599d
Info border
icon/state/info
#004275
Info icon
background/state/success/subtle
#eefff5
Success background
border/state/success
#049442
Success border
icon/state/success
#049442
Success icon
background/state/warning/subtle
#fff6ee
Warning background
border/state/warning
#8c7314
Warning border
icon/state/warning
#6a560a
Warning icon
background/state/error/subtle
#ffeae7
Error background
border/state/error
#bc1700
Error border
icon/state/error
#931200
Error icon
text/primary
#3b3b3d
Title text
text/secondary
#4f5052
Body + close icon
radius/sm
4px
Corner radius
stroke-weight
1px
Border width
width
480px
Fixed alert width

Guidelines

Do
  • Match tone to severity — info, success, warning, error
  • Include actionable information ("Try again", "Contact support")
  • Always include both a title and a short description
  • Keep error alerts persistent — never auto-dismiss
  • Stack no more than 2 alerts in the same region
Don't
  • Use alerts for marketing or feature promotions
  • Auto-dismiss error alerts — users need time to read
  • Use error tone for warnings — reserve it for blocking failures
  • Write vague messages like "Something went wrong"
  • Put interactive widgets inside the alert body