Practical Guide

Color Contrast Calculator — Usage Guide and Technical Principles

Check WCAG 2.1 contrast ratios between any foreground and background colors, preview sample text, and see AA/AAA pass results instantly.

Open tool

Overview

Color contrast testing ensures text or icons remain legible by measuring the difference between foreground and background luminance, a key requirement in WCAG and most brand guidelines.

Key concepts

Relative luminance

Each RGB channel is converted to a linear value using the WCAG gamma curve before computing luminance with coefficients 0.2126, 0.7152, and 0.0722.

Contrast ratio

The ratio formula (L1 + 0.05) / (L2 + 0.05) compares the lighter and darker colors to ensure consistent readability across devices.

Thresholds

AA normal text requires ≥ 4.5:1, large text ≥ 3:1, AAA normal needs 7:1, AAA large 4.5:1, and graphical objects should meet 3:1.

Key features

Live color picking

Adjust foreground and background colors with the Ant Design picker or type precise HEX values.

WCAG matrix

See AA/AAA requirements for normal text, large text, and UI graphics in a single table.

Accurate luminance

Contrast ratios follow WCAG 2.1 using linearized RGB channels and include per-color luminance readouts.

Preview block

Test headings and paragraphs inside a live sample card with your chosen palette.

Use Cases

Design asset preparation

Use Color Contrast Calculator to create, inspect, adjust, or validate visual assets before adding them to websites, product screens, documents, or presentations.

Visual quality checks

Color Contrast Calculator helps catch image, color, metadata, layout, or accessibility issues early in the content production workflow.

Team handoff

Prepare clearer outputs with Color Contrast Calculator for designers, developers, marketers, support teams, and documentation maintainers.

Frequently asked questions

Does large text use different thresholds?

Yes. Text ≥ 18px regular or 14px bold qualifies as large and only needs 3:1 for AA or 4.5:1 for AAA.

How do I test gradients?

Check the lightest and darkest stops in the gradient. Each stop pair should meet the desired ratio.

Do icons count as text?

Solid icons and essential UI graphics should meet at least 3:1 contrast relative to their background.

Related documentation

Color Contrast Calculator

Open the tool to try these features.

Open tool