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.

Https

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.

Components

Address block

Use: Best practice Web
Address block is used to highlight mailing and physical addresses and contact information for VA facilities (with some notable exceptions). It can also be used to display personal information we may have for a Veteran.

Examples

View this in Storybook

Usage

When to use address block

  • Addresses in content blocks: Use an address block to call out an address when it sits within a content block. The blue bar will bring attention to the address block and make it easier to find when scanning a page.
  • Form intro pages: Use an address block on form introductory pages where the mailing address is needed.

When to consider something else

  • Clear Address header: If the Address is directly below a clear header named “Address”, as it is on VA Health Center pages, then the address block with blue border is not necessary.
  • Accordions for a series: If you have a series of addresses in the body of a page and outside of a form or tool then an Accordion can be used. For example, if you have 3 or more addresses in succession.
  • Phone numbers in isolation: If you need to show one or more phone numbers, use the Telephone component.

Placement

  • Address block can appear within a block of content following a paragraph, list, or header.

Instances of this component in production

Example of this component in isolation.
Use of this component for a VA Debt Management Center address.

Like this

Example of this component to show Veteran personal information.
Use of this component for Veteran personal information.

Not this

Example of this component used incorrectly for phone numbers instead of addresses and by directly overriding styles to remove the blue border.
Use of this component is not for phone numbers in isolation and the blue border should not be removed.

Code usage

  • The Address block component is created by applying the CSS class .va-address-block to a <p> HTML element.
  • Only use the <address> HTML element for contact information related to the current page. <address> is only intended for contact information and not physical addresses (e.g. not for a Health Center facility address).

Content considerations

Don’t use periods in PO for PO Box.

Write out street names (street, road, avenue, boulevard, highway, etc.) in both body copy and in address blocks. Don’t abbreviate.

When a street address contains a compass point (north, south, etc.), defer to the way it’s referenced locally. For example, some cities may abbreviate compass points like north and south for some but not all streets.

In the examples below, we spell out the street names, and style the compass points the way they're locally referenced in Washington, D.C., and New York City, which both abbreviate compass points.

Like this

1600 Pennsylvania Avenue, NW
Washington, DC 20500

123 E. 45th Street
New York, NY 67890

Not this

1600 Pennsylvania Ave. Northwest
Washington, DC 20500

123 East 45th St.
New York, NY 67890

Zip codes

  • When Veterans fill out their address, we don’t require them to include the extra 4 digits of their zip code. They only need to provide the 5-digit zip code.
  • When we provide an address to Veterans, we sometimes include the extra 4 digits of the zip code. If we include the extra 4 digits, use a hyphen (ex. 12345-6789).

Component checklist

Web Platform

87%

7 of 8 complete

Maturity

Guidance

Web

Examples, usage, code usage, content considerations, and accessibility considerations are all complete.

Research

Web

VFS team conducted research on this component which is linked from this page.

Stability

Web

Component has been in production for more than 3 months with no significant issues found.

Adoption

Web

Multiple teams have adopted this component.

Accessibility

While this component has been previously tested against older criteria, it has not yet been audited with the updated testing criteria.

Code assets

Variations

Web

Storybook includes all variations (style, size, orientation, optional iconography, selection, error state, etc.)

Responsive

Web

Component depicted in all responsive breakpoints.

Interactive states

N/A Web

Includes all interactive states that are applicable (hover, active, focus, keyboard focus, disabled).

Tokens

N/A Web

All design attributes (color, typography, layout, etc.) are available as tokens.

Internationalization

N/A Web

Describes i18n attributes.

Visual assets

Variations

Web

Figma library includes all variations (style, size, orientation, optional iconography, selection, error state, etc.)

Responsive

Web

Component designed to work in all responsive breakpoints.

Interactive states

N/A Web

Includes all interactive states that are applicable (hover, active, focus, keyboard focus, disabled).

Tokens

N/A Web

All design attributes (color, typography, layout, etc.) are available as tokens.

Legend:

  • Complete
  • Incomplete
  • N/A Not applicable

Provide feedback

Share your feedback, report issues, or suggest improvements for the Address block component. Your input helps us make the design system better for everyone.

Edit this page in GitHub (Permissions required)
Last updated: Sep 10, 2025