Guidelines

Usage

Defining how we apply color to user interfaces

The use of color plays a key role in how we convey emotions, establish brand identity, and guide user interactions. Consistent and thoughtful color choices also improve usability, highlight important elements, and create a cohesive design language across the product.

Icons

Icons provide visual cues in the user experience and improve recognition by conveying information in a compact and easily recognizable form. Use of color in icons should coordinate with the space they occupy and any text.

General principles

  • Use neutral Black as default
  • Color icons can be paired with text of same emphasis or neutral (strong)
  • Avoid pairing icon emphasis or colors with text or backgrounds of different colors
  • Icons should be singular solid color

Neutral

Use to express default and less-opinionated UI elements such as background colors, icons, and text elements.

ColorEmphasisDescription
Gray
mediumIcon color indicating empty states for icons (ex: empty star rating")
White
inverseIcon color on medium or strong emphasis backgrounds and colored surfaces (also used on medium and strong colored surfaces)
Black
defaultDefault icon color on neutral surfaces
Examples
user interface example where neutral colors are applied to icons

Primary and info

Use our brand color to tie in the most important user moments with how we express ourselves as an organization through our identity. You can also use these in info moments.

ColorEmphasisDescription
Blue 600
strongIcon color primary on 100-level blue surfaces or paired with text of same color value
Blue
defaultIcon color on a default neutral surface
Blue 500
mediumIcon color primary on default neutral surfaces or paired with text of same color value
Examples
user interface example where primary colors are applied to icons
Add missing guidance to usage content mapping
ColorEmphasisDescription
Indigo 600
strongIcon color guidance on 100-level indigo surfaces or paired with text of same color value
Indigo
defaultIcon color on a default neutral surface
Indigo 500
mediumIcon color guidance on default neutral surfaces or paired with text of same color value
Examples
user interface example where guidance colors are applied to icons

Accents

Use as a subtle background for accent purposes.

ColorEmphasisDescription
Purple
defaultIcon color on a default neutral surface
Examples
user interface example where accent colors are applied to icons

Success, finance and ratings

Use for positive monetary moments, like income patterns, discounts, savings, and revenue growth.

ColorEmphasisDescription
Green 600
strongIcon color success on 100-level green surfaces or paired with text of same color value (ex: savings, discounts, revenue growth, etc)
Green 500
mediumIcon color success on default neutral surfaces or paired with text of same color value (ex: savings, discounts, revenue growth, etc)
Green
defaultIcon color on a default neutral surface (ex: savings, discounts, revenue growth, etc)
Examples
user interface example where success colors are applied to icons

Alert

Use to convey a sense of urgency, to assist in preventing potential errors or security issues, and for negative monetary moments like revenue loss.

ColorEmphasisDescription
Red 600
strongIcon color alert on 100-level red surfaces or paired with text of same color value (ex: revenue loss)
Red
defaultIcon color on a default neutral surface (ex: revenue loss)
Red 500
mediumIcon color alert on default neutral surfaces or paired with text of same color value (ex: revenue loss)
Examples
user interface example where alert colors are applied to icons

Caution

Use for moments that are trending in a negative direction, but don't require the user to take immediate action.

ColorEmphasisDescription
Black
strongIcon color caution on 100-level neutral surfaces or paired with text of same color value (ex: downward trends)
Yellow
defaultIcon color on a default neutral surface (ex: downward trends)
Yellow 600
mediumIcon color caution on default neutral surfaces or paired with text of same color value (ex: downward trends)
Examples
user interface example where caution colors are applied to icons