Skip to main content

An official website of the United States government

Here's how you know

An official website of the United States government

Here's how you know

Theme:

Design system switcher

Version:

Design system switcher

Theme:

Design system switcher

Version:

Design system switcher

Theme colors

The design system provides a flexible color palette that meets accessible color contrast requirements.

Color is a key element in our design system used to create meaning and consistency. Our color palette helps to unify our brand’s experiences, from product interfaces to marketing.

You can apply color to:

  • Convey emotion
  • Express a tone
  • Guide attention
  • Pinpoint critical items

Below you will find a set of well-defined guidelines on how to work with our colors.

Brand colors

Primary colors

Our primary color palette is designed for use throughout our digital products within interfaces and for branding. Primary colors are displayed most frequently across our products' screens and components.

Primary colors are used for:

  • Key actions such as primary call to action buttons
  • Highlighted content
  • Form field elements

We chose colors that offer a range of uses and that meet or exceed standards in supporting accessibility and contrast for low vision users.

The guidelines indicate how colors should be applied, noting where some should be utilized sparingly and with purpose for specific components like errors or messaging.

--color-primary-lightestocean-50
--color-primary-lighterocean-100
--color-primary-lightocean-300
--color-primaryocean-500
--color-primary-darkocean-600
--color-primary-darkerocean-700
--color-primary-darkestocean-800

Secondary colors

These are accent colors to provide additional lightness and style to pages looking for a more modern flair. These colors should be used to highlight important features on a page, such as buttons, or for visual style elements, such as illustrations. They should be used sparingly and never draw the eye to more than one piece of information at a time.

--color-secondary-lightestspring-50
--color-secondary-lighterspring-100
--color-secondary-lightspring-300
--color-secondaryspring-500
--color-secondary-darkspring-600
--color-secondary-darkerspring-700
--color-secondary-darkestspring-800

Accent colors

Accent colors are used sparingly to support primary and secondary colors in designs and illustrations.

Primary accent colors

--color-accent-primary-lightestpersimmon-50
--color-accent-primary-lighterpersimmon-100
--color-accent-primary-lightpersimmon-300
--color-accent-primarypersimmon-500
--color-accent-primary-darkpersimmon-600
--color-accent-primary-darkerpersimmon-700
--color-accent-primary-darkestpersimmon-800

Neutral colors

--color-whitewhite-solid
--color-gray-lightestgranite-50
--color-gray-lightergranite-100
--color-gray-lightgranite-300
--color-graygranite-500
--color-gray-darkgranite-700
--color-gray-darkergranite-800
--color-gray-darkestgranite-900
--color-blackblack-solid

Text colors

--color-basegranite-900

Background colors

These colors are used largely for background blocks and large content areas. When alternating between tones, be sure to use enough contrast between adjacent colors.

--color-backgroundwhite-solid
--color-background-inverseocean-800

Status colors

These colors are used largely to indicate the status of something. Be cautious using these colors to signify something that may contradict what most people would expect the colors to be used for.

Informational

--color-info-lightestsky-50
--color-info-lightersky-100
--color-info-lightsky-300
--color-infosky-500
--color-info-darksky-600
--color-info-darkersky-700
--color-info-darkestsky-800

Success

--color-success-lightestspring-50
--color-success-lighterspring-100
--color-success-lightspring-300
--color-successspring-500
--color-success-darkspring-600
--color-success-darkerspring-700
--color-success-darkestspring-800

Warn

--color-warn-lightestgoldenrod-50
--color-warn-lightergoldenrod-100
--color-warn-lightgoldenrod-300
--color-warngoldenrod-500
--color-warn-darkgoldenrod-600
--color-warn-darkergoldenrod-700
--color-warn-darkestgoldenrod-800

Error

--color-error-lightestrose-50
--color-error-lighterrose-100
--color-error-lightrose-300
--color-errorrose-500
--color-error-darkrose-600
--color-error-darkerrose-700
--color-error-darkestrose-800

Focus colors

--color-focus-lightwhite-solid
--color-focus-darkorchid-500

Accessibility considerations

Text contrast

WCAG 2.0+ AA requires a contrast ratio of a minimum of 4.5:1 for normal, or body, text. Large text is easier to read, so the contrast requirement is reduced to 3:1. WCAG defines large text as text that is 24px and larger or 18.5px and larger if it is bold.

Text over gradients and background images still need to meet contrast requirements.

Non-text contrast

Elements that are not text, but still important, including buttons, icons that convey information, data visualizations (charts and graphs), and form inputs need a contrast ratio of at least 3:1. Also included in this are states of elements such as the selected state of an element, expanded vs. collapsed, active vs. inactive, elements with keyboard focus, etc.

Easily test your color combinations

Note that the colors listed only display colors that are available but when you are pairing colors together, make sure the color contrast ratio is sufficient. Here are three tools we suggest for testing color contrast:

WebAIM Color Contrast Checker

Deque Color Contrast Analyzer

Color Contrast Analyzer by TPGi