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

Background Color

Use the background color utility to change the default background color of an element.

Format: .ds-u-fill--[COLOR NAME]-[SHADE]

Brand colors

Primary Colors

Secondary Colors

Accent colors

Primary accent colors

Neutral colors

Background Colors

Status colors

Informational

Success

Warn

Error

Focus Colors

Additional 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 Checker

Deque Color Contrast Analyzer

Color Contrast Analyzer by TPGi