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.

Patterns

Email template

email template

Guidance

When to use

The email template is used to communicate with Veterans through email. This template is primarily used for transactional emails such as submission confirmations, status changes, and account changes. It may also be used for informational messages. The visual styles supported by email notifications are below along with guidelines for how to best use them within the template.

When incorporating e-mail notifications into a VA.gov application, we recommend using VA Notify.

The header includes the VA logo with appropriate alt text. No changes should be made to the header to ensure consistency across emails sent by VA.

Heading

An H1 heading is used to convey the purpose of the email. Use only one heading per email. Heading level 2 is also supported.

Paragraph text

Paragraph text is used for the body content of the email. Bold, italics, and bulleted lists are also supported.

Bulleted lists

Bulleted lists are supported to break up paragraph content. The style follows the VA design system bullet styling.

Links are supported and follow the style of design system links. When links are critical for the user to visit, the full URL should be displayed to set expectations and allow for copying and pasting.

Card

Cards are used to call out important pieces of information included in the email. Examples of this include confirmation numbers, important dates, etc.

The footer is used to communicate supplemental information about the communication such as an explanation of why the email was sent, how to unsubscribe, or how to get additional support. The footer is noted with the use of a horizontal line.

Typography

Because of limited support by email clients for custom typefaces, typography within emails uses system fonts and may differ from the types styles defined in the design system.

Smaller screen design styles

The text styles are the same on mobile. For email on smaller screens, the VA logo is centered on the header.

Edit this page in GitHub (Permissions required)