Legibility standards
WCAG standards
All text should be legible and meet accessibility standards. The Web Content Accessibility Guidelines (WCAG 2.0) level AA requires a 4.5:1 color contrast between text...
All text should be legible and meet accessibility standards.
To learn more about color, contrast, and accessibility design, read
Text backgrounds
Text on colored backgrounds
Black text is recommended for use on light backgrounds, and white text on dark backgrounds. If your app has both light and dark themes, make...
Black text is recommended for use on light backgrounds, and white text on dark backgrounds. If your app has both light and dark themes, make sure the text is available in a contrasting color against each theme.
Colored backgrounds or typography additionally change the rules regarding text opacity and different states of text.
Using text opacity
Instead of using grey text and icons on top of colored backgrounds, create better contrast by displaying white or black text with reduced opacity. For...
Instead of using grey text and icons on top of colored backgrounds, create better contrast by displaying white or black text with reduced opacity.
For example, black text displayed at 75% opacity on a green background gives the text an appearance of black, with a hint of green.
Alternatively, you can calculate the color of text by doing the following:
- Place the color black at reduced opacity in front of a green background
- Identify the hex value of the resulting darkened green color
- Use that hex value of that color for your text
In this case, if the surface behind the text changes color, you must update the hex color as well.
Dark text on light backgrounds
Dark text on light backgrounds (shown here as #000000 on #FFFFFF) applies the following opacity levels:
Dark text on light backgrounds (shown here as #000000 on #FFFFFF) applies the following opacity levels:
- High-emphasis text has an opacity of 87%
- Medium-emphasis text and hint text have opacities of 60%
- Disabled text has an opacity of 38%
Colored text and backgrounds
Colored text should be used sparingly to draw attention and apply selective emphasis. Ideally colored text should be reserved for text elements such as headlines,...
Colored text should be used sparingly to draw attention and apply selective emphasis. Ideally colored text should be reserved for text elements such as headlines, buttons, and links.
Text types
Helper Text
Helper text gives context about a field’s input, such as how the input will be used. It can adopt brand colors, but should be legible...
Helper text gives context about a field’s input, such as how the input will be used. It can adopt brand colors, but should be legible as determined by WCAG standards.
For example, helper text on light backgrounds could apply the following opacity levels and default hexes:
- High emphasis helper: This text uses a hex value #000000 at 87% opacity
- Default color helper text: This text uses a hex value of #000000 at 60% opacity
- Default error helper text: This text uses a hex value of #B00020 at 100% opacity
Selected Text
To reflect brand, text selection can use an accent of your primary or secondary color. Selected text should be legible against the selection color, and...
To reflect brand, text selection can use an accent of your primary or secondary color.
Selected text should be legible against the selection color, and the selection color should contrast the background color. Alternatively, you can display outlines, motion, checkmark icons, or other text treatments to indicate selected text.
Learn more about contrast (or try a color contrast analyzer) at
Icons and Other symbols
Icons and other elements don’t need to meet WCAG legibility standards, but should be as visible as possible to indicate function or communicate information. For...
Icons and other elements don’t need to meet WCAG legibility standards, but should be as visible as possible to indicate function or communicate information.
For example, dark icons (#000000) or other elements on light backgrounds (#FFFFFF) could apply the following opacity levels:
- Active icons have an opacity of 87%
- Inactive icons have an opacity of 60%
- Disabled icons have an opacity of 38%