Workday Canvas

Color Contrast

The global palette is designed with accessibility in mind, making it easy to create accessible color combinations without needing a contrast calculator.

Color pairings should pass contrast requirements to ensure content is readable for everyone. Colors in the palette are built with contrast baked in to make it simple to create accessible color combinations.

Canvas believes that designing for accessible experience benefits everyone. Improved contrast improves readability in bright sunlight, low-quality displays, and for users experiencing temporary vision impairment. Using the color system can help reduce the guesswork in choosing colors and ensure contrast ratios when applied.

Understanding Contrast

Contrast measures the difference in brightness between two colors, ensuring that content is perceivable and readable against backgrounds. WCAG 2.1 guidelines specify a minimum contrast ratio of 4.5:1 for text, 3:1 for interactive elements, and 7:1 for high contrast. The global palette and tonal scale are designed with target contrast ratios baked in, making it straightforward to achieve compliant color combinations without a separate calculator.

Color contrast demonstration showing different step differences and their compliance levels

Text examples showing AA compliance (4.5:1) with black text on light gray, and AAA compliance (7:1) with white text on dark blue backgrounds

Usage Guidance

  1. Use color roles to guarantee accessibility through design tokens.
  2. Use the contrast framework: If you need to choose colors from directly from the palette, make sure to choose accessible color combinations. Use the contrast framework to make it easy to select accessible pairs just from the step number.
  3. Check your designs against color-blindness and low-vision simulators to get a feel for what your design might look like in different scenarios.
  4. Avoid the use of color alone to communicate information.

Color role examples showing bg-primary and text-primary automatically maintaining proper contrast ratios across light and dark themes

Accessible Color Combinations

Colors are graded using a 15 step tonal scale. Each step is assigned to a number that represents the lightness of that color relative to other colors in the scale. For example, 0 is the lightest color in the scale (white), and 1000 is the darkest color (black). A 500 color would have a lightness value between the two, with lighter and darker variations on both sides. To determine if a color will pass contrast, compare step numbers and the difference between the two.

Regular text requires a 500+ step difference to achieve the 4.5:1 ratio needed for AA compliance. For enhanced accessibility, text can use a 700+ step difference to achieve the 7:1 ratio that exceeds AAA compliance standards. For non-text contrast, a 400+ step difference is needed (if both colors have step numbers greater than 200+|)

Overview

ContentWCAG LevelTarget RatioStep DifferenceExample
TextAA4.5:1500+slate-100 on slate-600
TextAAA7:1700+slate-100 on slate-800
Non-textAA3:1400+ (>200)blue-600 on blue-100
Non-textAAA4.5:1500+blue-100 on blue-600

Text Contrast

Normal sized text should have at least at 4.5:1 contrast to meet Level AA compliance. A difference of 500 or more between steps guarentees it passes text contrast guidelines.

Step difference examples showing 500+ differences guarantee 4.5:1 text contrast across various background and text color combinations

BackgroundForeground StepStep DifferenceCompliance Level
0(white)600600AA Text
100600500AA Text
200700500AA Text
300800500AA Text
400900500AA Text
5001000 (black)500AA Text

Non-text Contrast

Interactive elements and non-decorative visuals (icons) should have a contrast of 3:1 to meet Level AA compliance.

A difference of 400 or more between steps guarantees a contrast of 3:1 for steps greater than 200.

Interactive elements showing buttons, form inputs, and icons meeting 3:1 contrast requirements with 400+ step differences

BackgroundForeground StepStep DifferenceCompliance Level
0(white)500500AA Non-text
25500475AA Non-text
200600400AA Non-text
300700400AA Non-text
400800400AA Non-text
500900400AA Non-text
6001000 (black)400AA Non-text

High Contrast (> 7:1)

Level AAA contrast should be targeted when you are designing for low vision or colorblindness. For both text and non-text contrast, this means the target difference is increased (text increases to 700+, non-text increases to 500+).

High contrast interface examples showing AAA compliance with 7:1+ ratios for enhanced accessibility and low vision support

BackgroundAA ContrastAAA ContrastAA DifferenceAAA Difference
0(white)700500700500
100800600700500
200900700700500
3001000 (black)800700500
4001000 (black)900600500
5000(white)0(white)500500
6000(white)0(white)600600
7000(white)100700600
800100200700600
900200300700600
1000 (black)300400700600

Can't Find What You Need?

Check out our FAQ section which may help you find the information you're looking for. For further information, contact the #ask-canvas-design or #ask-canvas-kitchannels on Slack.

On this Page: