Timely information
Alerts surface messages that are relevant to what a user is currently doing — not after they've moved on.
Alerts provide short, timely, and relevant information for your users. It can be a simple text message or customised HTML content with paragraphs, headings and links.
Alerts surface messages that are relevant to what a user is currently doing — not after they've moved on.
Contextual tones — info, success, warning, danger — tell users at a glance how urgently they need to act.
Inline alerts don't interrupt or redirect — they sit within the page so users stay oriented while being informed.
Container
Leading icon (optional)
Title (optional)
Description
Dismissible - close button (optional)
The alert offers variants to convey a different level of importance.
Use to provide general context or neutral information, such as announcements or guidance that don't indicate a status outcome, in either filled or outlined style.
The alert supports two styles—filled and outlined.
Use filled alerts when the message needs stronger visual emphasis, such as higher-priority updates or messages users should notice immediately.
The alert can be manually dismissed by the user.
Use for persistent messages that must remain visible, such as system statuses or warnings the user needs to act on.
Alerts may include an icon to reinforce meaning. The icon should support, not replace, the message text.
Use when the message is self-explanatory or when a minimal, text-only appearance is preferred.
Alerts can include a title to summarise the message and provide hierarchy, especially for longer or more complex content.
Use for short, single-line messages that are easy to scan without an additional heading.
The default slot can contain supplementary content such as links or supporting actions, as long as the message remains clear and easy to scan.
Use when the alert message is complete without extra supporting content.
Component tokens are specific to Alert. Use the table title as the prefix: padding-x under sgds/alert means sgds/alert/padding-x; bg-emphasis under sgds / alert / info means sgds/alert/info/bg-emphasis.
sgds/padding/lgsgds/padding/lgsgds/padding/2-xlsgds/gap/smsgds/gap/2-xssgds/gap/mdsgds/border-width/1sgds/border-radius/mdsgds/primary/surface-defaultsgds/primary/surface-mutedsgds/primary/border-color-mutedsgds/success/surface-defaultsgds/success/surface-mutedsgds/success/border-color-mutedsgds/danger/surface-defaultsgds/danger/surface-mutedsgds/danger/border-color-mutedsgds/warning/surface-defaultsgds/warning/surface-mutedsgds/warning/border-color-mutedsgds/neutral/surface-emphasissgds/neutral/surface-mutedsgds/neutral/border-color-mutedA clear title, short body, and suitable variant help users understand what needs attention.
Too many alerts compete for attention and make it harder to spot the message that matters.
Alerts expose their message as an alert region when they are shown.
Dismissible alerts use the SGDS close button for the close action.
This component does not have a separate keyboard interaction table because:
Share them with us on
Report it on GitHub
The Singapore Government Design System was developed to empower teams in creating fast, accessible and mobile-friendly digital services.