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.

These colors are currently found in components throughout the design system, but don’t represent the entire available palette.

CSS:
--color-primary-lightest
Hex:
#e6f1f8
Figma:
Ocean 50
Used in:
Day Picker, Filter Chip
CSS:
--color-primary
Hex:
#0071bc
Figma:
Ocean 500
Used in:
Badge, Button, Choice, Filter Chip, Link, Pagination, Steplist, Tabs, Tooltip, Vertical Nav, USA Banner
CSS:
--color-primary-darker
Hex:
#004f84
Figma:
Ocean 700
Used in:
Button, Choice, Link, Pagination, Tabs
CSS:
--color-primary-darkest
Hex:
#00395e
Figma:
Ocean 800
Used in:
Button, Link, Pagination

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.

These colors are currently found in components throughout the design system, but don’t represent the entire available palette.

CSS:
--color-secondary-lightest
Hex:
#e7f3e7
Figma:
Spring 50
Used in:
Button
CSS:
--color-secondary-lighter
Hex:
#b8dcb7
Figma:
Spring 100
Used in:
Button
CSS:
--color-secondary-light
Hex:
#59ac56
Figma:
Spring 300
Used in:
Button
CSS:
--color-secondary
Hex:
#12890e
Figma:
Spring 500
Used in:
Button
CSS:
--color-secondary-darker
Hex:
#0d600a
Figma:
Spring 700
Used in:
Button
CSS:
--color-secondary-darkest
Hex:
#094507
Figma:
Spring 800
Used in:
Button

Accent colors

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

Primary accent colors

Neutral colors

These colors are currently found in components throughout the design system, but don’t represent the entire available palette.

CSS:
--color-white
Hex:
#ffffff
Figma:
White solid
Used in:
Accordion, Alert, Badge, Button, Choice, Drawer, Filter Chip, Steplist, Spinner, Tooltip
CSS:
--color-gray-lightest
Hex:
#f2f2f2
Figma:
Granite 50
Used in:
Accordion, Button, Drawer, Table, Vertical Nav, USA Banner
CSS:
--color-gray-lighter
Hex:
#d9d9d9
Figma:
Granite 100
Used in:
Accordion, Button, Choice, Pagination, Tabs, Text Input, USA Banner
CSS:
--color-gray-light
Hex:
#a6a6a6
Figma:
Granite 300
Used in:
Choice, Text Input, Tooltip
CSS:
--color-gray-dark
Hex:
#5a5a5a
Figma:
Granite 700
Used in:
Badge, Button, Pagination, Vertical Nav
CSS:
--color-gray-darker
Hex:
#404040
Figma:
Granite 800
Used in:
Button, Drawer, Tabs, Tooltip
CSS:
--color-black
Hex:
#000000
Figma:
Black solid
Used in:
Drawer, Table, Text Input

Text colors

These colors are currently found in components throughout the design system, but don’t represent the entire available palette.

CSS:
--color-base
Hex:
#262626
Figma:
Granite 900
Used in:
Global, Accordion, Alert, Badge, Button, Choice, Filter Chip, Pagination, Steplist, Spinner, Tabs, Text Input, Tooltip, Vertical Nav

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.

These colors are currently found in components throughout the design system, but don’t represent the entire available palette.

CSS:
--color-background
Hex:
#ffffff
Figma:
White solid
Used in:
Choice, Dialog, Drawer, Spinner, Tabs, Tooltip
CSS:
--color-background-inverse
Hex:
#00395e
Figma:
Ocean 800
Used in:
Spinner

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

These colors are currently found in components throughout the design system, but don’t represent the entire available palette.

CSS:
--color-info-lightest
Hex:
#e6f9fd
Figma:
Sky 50
Used in:
Alert, Drawer
CSS:
--color-info
Hex:
#02bfe7
Figma:
Sky 500
Used in:
Alert, Drawer

Success

These colors are currently found in components throughout the design system, but don’t represent the entire available palette.

CSS:
--color-success-lightest
Hex:
#f6faf5
Figma:
Spring 40
Used in:
Alert
CSS:
--color-success-light
Hex:
#59ac56
Figma:
Spring 300
Used in:
USA Banner
CSS:
--color-success
Hex:
#12890e
Figma:
Spring 500
Used in:
Alert, Badge

Warn

These colors are currently found in components throughout the design system, but don’t represent the entire available palette.

CSS:
--color-warn-lightest
Hex:
#fef9e9
Figma:
Goldenrod 50
Used in:
Alert
CSS:
--color-warn
Hex:
#f8c41f
Figma:
Goldenrod 500
Used in:
Alert, Badge

Error

These colors are currently found in components throughout the design system, but don’t represent the entire available palette.

CSS:
--color-error-lightest
Hex:
#fef5f7
Figma:
Rose 40
Used in:
Alert
CSS:
--color-error-lighter
Hex:
#f7bbc5
Figma:
Rose 100
Used in:
Inline Error, Text Input
CSS:
--color-error
Hex:
#e31c3d
Figma:
Rose 500
Used in:
Alert, Badge, Inline Error, Text Input

Focus colors

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 CheckerThis link goes to an external site

You are leaving design.cms.gov.

You're about to connect to a third-party site. Select CONTINUE to proceed or CANCEL to stay on this site.

Learn more about links to third-party sites.

Continue

Deque Color Contrast AnalyzerThis link goes to an external site

You are leaving design.cms.gov.

You're about to connect to a third-party site. Select CONTINUE to proceed or CANCEL to stay on this site.

Learn more about links to third-party sites.

Continue

Color Contrast Analyzer by TPGiThis link goes to an external site

You are leaving design.cms.gov.

You're about to connect to a third-party site. Select CONTINUE to proceed or CANCEL to stay on this site.

Learn more about links to third-party sites.

Continue