pattern-library checked
U.S. Web Design System Banner Component
Documents official-site identity banners that appear at the top of every page, use consistent text, avoid misleading use, and include accessibility guidance for labelled banner regions.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Banner | Choose banner when the message scope spans multiple pages, sections, records, or sessions in the same product, service, account, or workspace. | The banner appears before users encounter content affected by the message. | USWDS banner guidance supports consistent top-of-page official identity messages and cautions against misleading use. |
| Official-site banner | Choose official-site banner when a page is eligible to claim official government or public-authority identity and users need to verify domain and secure connection status. | The banner appears before the header, service navigation, site alerts, notification banners, and main content. | Supports official-site identity, .gov explanation, secure HTTPS explanation, top placement, and accessibility guidance. |
Evidence Role
This source is treated as pattern-library evidence. Use it to validate the decision rules above, not as a visual style reference.
Publisher: U.S. Web Design System. Last checked: .