Color

Color roles are like the "numbers" in a paint-by-number canvas. They're the connective tissue between elements of the UI and what color goes where.

What are color roles?

 

  • Color roles are mapped to the Components. You'll use these color roles whether you're using the static baseline scheme or dynamic color. If your product contains custom components, they'll need to be properly mapped to this set of color roles.
  • Color roles ensure accessibility. The color system is built on accessible color pairings. These color pairs provide an accessible minimum 3:1 contrast.
  • Color roles are tokenized. Roles are implemented in design and code through tokens. A design token represents a small, reusable design decision that’s part of a design system's visual style.

 

Surfaces

 

Surface colors define contained areas, distinguishing them from a background and other on-screen elements. There are two core surface roles: surface and surface-dark. In addition to elevation roles: surface-variant-1 ... -3.

Surfaces

On surface colors

Whenever elements such as text or icons appear in front of those surfaces, their colors be clear and legible against the color behind them.

This type of color is called an “on” color, referring to the fact that it appears “on” top of surfaces. “On” colors are primarily applied to text, icons, and strokes.

On surface colors

Mapping

Surface color is the recommended default color for a body region of the app. It provides good contrast and can be flexibly combined with all other surface roles and content colors.

In the example below, a mobile device uses surface for the body region and surface varient for the navigation region. When the same application scales to a larger device, these color mappings remain the same for their layout regions.

Mapping

Surface container colors

Neutral-colored components such as action bar, card, menus, or dialogs are mapped to specific surface-variant roles by default.

Surface container colors

Alternative surface colors

Additional surface color role are variants to the default surface role. Surface-dark will always be the dimmest surface color in light or dark themes.

Alternative surface colors

Inverse roles

These additional role mappings exist in a scheme and are mapped to components where needed.

Inverse roles

Outlines

Outline is a utility color that creates boundaries for decorative elements when a 3:1 contrast isn’t required, such as for dividers or decorative elements.

Outlines 1

Outline-dark is a utility color that creates boundaries and emphasis to improve usability. The outline color has a 3:1 contrast with all surface colors.

Outlines 2

Surfaces and elevation

Surfaces at different elevations do the following:

  • Allow surfaces to move in front of and behind other surfaces, such as content scrolling behind navigation bar
  • Reflect spatial relationships, such as how a floating action button’s shadow indicates it is separate from a card collection
  • Focus attention on the highest elevation, such as a dialog temporarily appearing in front of other surfaces
Surfaces and elevation

Find more in Surfaces and Elevation guidelines


Accent colors

 

Acent colors is used to derive roles for key components across the UI, buttons, active states.

Primary

Primary roles are used for key components across the UI, buttons.

An “on-color” is a color role used by the content. Each container color has its own corresponding on color. For example, if a container color is “primary-container”, the content will use the “on-primary-container” color role.

Primary / On primary
Primary container / On primary container

Secondary

Secondary roles are used for less prominent components in the UI, such as filter chips, while expanding the opportunity for color expression.

Secondary / On secondary

Secondary / On secondary

Secondary container / On secondary container

Secondary container / On secondary container


Product-specific colors

 

Custom colors have no semantic meaning attached to them. They can be used to show relationships between content types (e.g., features, categorization, labels, badges).

Custom colors used to give teams more control and customization alongside the variability of a dynamic color environment.

Product-specific colors

Custom color

Designed for stronger borders on interactive components,

  • Component backgrounds
  • Graphics
  • Coloured shadows
  • Accent borders
Custom color

Custom color container (saturated)

Designed for subtle borders on interactive components and focus rings

  • Hover states
  • Pressed or selected states
  • Overlays
Custom color container (saturated)

Custom color container

Designed for app backgrounds and subtle component backgrounds, subtle borders on components which are not interactive.

  • Card background
  • Badges
  • Banners
  • Notiffications
  • Striped table background
  • Sidebar background
  • Canvas area background
Custom color container

Color variants

Additional / Custom
#636363
custom-gray
fill color for product-specific features
Collection
Theme colors
Token set
-
#aeaeae
custom-gray-container-sat
Collection
Theme colors
Token set
-
#e5e5e5
custom-gray-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#c90324
custom-red
Collection
Theme colors
Token set
-
#f96c73
custom-red-container-sat
Collection
Theme colors
Token set
-
#fcc4c0
custom-red-container
Collection
Theme colors
Token set
-
#c22d00
custom-deep-orange
fill color for product-specific features
Collection
Theme colors
Token set
-
#fa7b5c
custom-deep-orange-container-sat
Collection
Theme colors
Token set
-
#fbcab1
custom-deep-orange-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#b74401
custom-orange
fill color for product-specific features
Collection
Theme colors
Token set
-
#f69037
custom-orange-container-sat
Collection
Theme colors
Token set
-
#fdd3a0
custom-orange-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#9e5c00
custom-amber
Collection
Theme colors
Token set
-
#e39b0d
custom-amber-container-sat
Collection
Theme colors
Token set
-
#fbdd93
custom-amber-container
Collection
Theme colors
Token set
-
#946c00
custom-yellow
fill color for product-specific features
Collection
Theme colors
Token set
-
#d9b517
custom-yellow-container-sat
Collection
Theme colors
Token set
-
#f1e67e
custom-yellow-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#4e7a00
custom-light-green
fill color for product-specific features
Collection
Theme colors
Token set
-
#9fd63f
custom-light-green-container-sat
Collection
Theme colors
Token set
-
#d8edb4
custom-light-green-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#007d08
custom-green
Collection
Theme colors
Token set
-
#78d97e
custom-green-container-sat
Collection
Theme colors
Token set
-
#c8f0cb
custom-green-container
Collection
Theme colors
Token set
-
#007546
custom-mint
fill color for product-specific features
Collection
Theme colors
Token set
-
#44d7a4
custom-mint-container-sat
Collection
Theme colors
Token set
-
#c2ede0
custom-mint-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#00726b
custom-teal
fill color for product-specific features
Collection
Theme colors
Token set
-
#51d6ca
custom-teal-container-sat
Collection
Theme colors
Token set
-
#c6ede9
custom-teal-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#006d81
custom-cyan
fill color for product-specific features
Collection
Theme colors
Token set
-
#52c7db
custom-cyan-container-sat
Collection
Theme colors
Token set
-
#caecf2
custom-cyan-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#0068b3
custom-light-blue
Collection
Theme colors
Token set
-
#4db4fd
custom-light-blue-container-sat
Collection
Theme colors
Token set
-
#d1e9fa
custom-light-blue-container
Collection
Theme colors
Token set
-
#225ec7
custom-blue
fill color for product-specific features
Collection
Theme colors
Token set
-
#6ea4f8
custom-blue-container-sat
Collection
Theme colors
Token set
-
#d7e6fc
custom-blue-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#4850e8
custom-indigo
fill color for product-specific features
Collection
Theme colors
Token set
-
#99a5fe
custom-indigo-container-sat
Collection
Theme colors
Token set
-
#dee3ff
custom-indigo-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#7533e8
custom-deep-purple
fill color for product-specific features
Collection
Theme colors
Token set
-
#b78cfc
custom-deep-purple-container-sat
Collection
Theme colors
Token set
-
#ede0ff
custom-deep-purple-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#992cd9
custom-purple
fill color for product-specific features
Collection
Theme colors
Token set
-
#dc88f7
custom-purple-container-sat
Collection
Theme colors
Token set
-
#f8dcfa
custom-purple-container
surface color for product-specific features
Collection
Theme colors
Token set
-
#cc1476
custom-pink
fill color for product-specific features
Collection
Theme colors
Token set
-
#f57cb1
custom-pink-container-sat
Collection
Theme colors
Token set
-
#ffdde8
custom-pink-container
surface color for product-specific features
Collection
Theme colors
Token set
-

On colors

An “on-color” is a color role used by the content. Each container color has its own corresponding “on-color”.

For example, if a container color is secondary container, the content will use the on secondary container color role

#ffffff
on-color
is applied to content (labels, icons, etc.) that sits on top of colored elements
Collection
Theme colors
Token set
-
#2d2d2d
on-color-container
is applied to content (labels, icons, etc.) that sits on top of colored-containers elements
Collection
Theme colors
Token set
-

Two-tone color pairing

Two color tokens of the same hue can be combined to create subtle background colors with colored icons. These are used for actions or objects that need additional visual distinction in the interface.

Two-tone color pairing

Semantic colors

 

Semantic colors have assigned meanings and are used to set expectations of meaning for users.

The semantic meanings include “informative,” “negative,” “notice,” and “positive.” Use semantic colors as a clear and predictable way to communicate meaning through a component’s appearance.

Color should never be used by itself for communication.

Semantic colors

Semantic color

Works best for small or tiny elments like a text, borders or icons.

Semantic color

Semantic color container (saturated)

Works best to color small and medium size areas like a chip or badge.

Semantic color container (saturated)

Semantic color container

Works best to color large areas like banners, toasts or cards.

Semantic color container

Semantic variants

Additional / Semantic
#c90324
semantic-negative
fill color for elements with negative meaning
Collection
Theme colors
Token set
-
#f96c73
semantic-negative-container-sat
Collection
Theme colors
Token set
-
#fcc4c0
semantic-negative-container
surface color for elements with negative meaning
Collection
Theme colors
Token set
-
#9e5c00
semantic-notice
fill color for elements with notification meaning
Collection
Theme colors
Token set
-
#e39b0d
semantic-notice-container-sat
Collection
Theme colors
Token set
-
#fbdd93
semantic-notice-container
surface color for elements with notification meaning
Collection
Theme colors
Token set
-
#007d08
semantic-positive
fill color for elements with positive meaning
Collection
Theme colors
Token set
-
#78d97e
semantic-positive-container-sat
Collection
Theme colors
Token set
-
#c8f0cb
semantic-positive-container
surface color for elements with positive meaning
Collection
Theme colors
Token set
-
#0068b3
semantic-informative
fill color for elements with informative meaning
Collection
Theme colors
Token set
-
#4db4fd
semantic-informative-container-sat
Collection
Theme colors
Token set
-
#d1e9fa
semantic-informative-container
surface color for elements with informative meaning
Collection
Theme colors
Token set
-

On colors

An “on-color” is a color role used by the content. Each container color has its own corresponding “on-color”.

For example, if a container color is secondary container, the content will use the on secondary container color role

#ffffff
on-color
is applied to content (labels, icons, etc.) that sits on top of colored elements
Collection
Theme colors
Token set
-
#2d2d2d
on-color-container
is applied to content (labels, icons, etc.) that sits on top of colored-containers elements
Collection
Theme colors
Token set
-

Two-tone color pairing

Two color tokens of the same hue can be combined to create subtle background colors with colored icons. These are used for actions or objects that need additional visual distinction in the interface.

Two-tone color pairing 2