Color and design guides

Read a Palette Contrast Matrix

·

A palette can offer useful accents alongside colors for text and controls. Test each pair against the threshold for the role it will serve, then confirm the colors and states used by the actual interface.

WCAG Palette Contrast Report

Test the six pairs in Four neutrals

Choose Four neutrals. The preset contains Ink (#000000), Paper (#FFFFFF), Slate (#777777) and Stone (#888888). Four colors give six unordered pairs. Three meet AA for normal text and only Ink and Paper meet AAA for normal text.

Compare Paper and Slate. The displayed 4.48:1 passes AA for large text and misses 4.5:1 for normal text. The ratio is symmetric, so changing which of these opaque swatches is the background leaves those verdicts the same.

Test the six pairs in Four neutrals
PairShown ratioAA normal
Ink / Paper21.00:1Pass
Ink / Slate4.69:1Pass
Paper / Slate4.48:1Fail
Paper / Stone3.54:1Fail

W3C WCAG 2.2 Contrast MinimumW3C WCAG contrast ratio definition

Choose a threshold for the text or control

For AA normal text, use the 4.5:1 column. The AA large text minimum is 3:1. Large-scale text is at least 18 pt, or 14 pt when bold, with provisions for equivalent CJK sizes.

Use the UI column for contrast between essential component or state information and its adjacent colors. The table compares one solid pair at a time. Check which colors actually touch each other in the component.

W3C WCAG 2.2 Contrast MinimumW3C WCAG 2.2 Non-text Contrast

Save the pair and threshold for review

Download the JSON report and find the Paper / Slate row. The ratio is approximately 4.478089 and normalAA is false. The criteria record gives the thresholds used for the table.

For a spreadsheet, download CSV and compare the Unrounded ratio and threshold columns. Keep the annotated component or design alongside the report so reviewers can distinguish actual uses from unused palette combinations.

W3C WCAG contrast ratio definition

Common questions

Why can the same pair work for a large heading and fail for a smaller caption?

WCAG AA uses 3:1 for large text and 4.5:1 for normal text. The colors produce the same ratio in both settings.

How do I review semi-transparent or gradient colors?

Use Contrast Checker to composite a solid pair on an opaque canvas. Review a gradient or image at the relevant text positions in the actual design.

Sources

Put it into practice.

Related guides