Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.


The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.


Banner - Official Gov

Use: Deployed
This banner identifies official websites of government organizations in the United States. They also help visitors understand whether a website is official and secure.



View va-official-gov-banner in Storybook


View va-official-gov-banner internationalization in Storybook


USWDS v3 component

This component comes directly from the U.S. Web Design System (USWDS). Thus we follow the guidance and considerations documented in the USWDS for this component. The guidance below augments the USWDS guidance to give specifics on how we use the component at the VA.

View USWDS guidance on Banner

When to use Banner - Official Gov

Always. The official government banner should appear on every page at the very top of the page.

How to use Banner

Auto-injected. The official government banner is automatically injected onto all pages using our content-build process.


Above header. The official government banner appears directly above the header and

Code usage

Attributes and Properties

Property Attribute Type Default Description
disableAnalytics disable-analytics boolean false If `true`, the component-library-analytics event is disabled.
tld tld string 'gov' Accepts a top level domain (TLD) value of either `gov` or `mil`. Default is `gov`.


Name Description
component-library-analytics The event used to track usage of the component.
Edit this page in GitHub (Permissions required)
Last updated: Jan 30, 2024