Skip to main contentCarbon Design System

Tooltip

Color

Interactive tooltip

ClassPropertyColor token
Labeltext color$text-secondary
Trigger iconsvg$icon-primary
Containerbackground-color$background-inverse
Textcolor$text-inverse
Closed and open states for a tooltip

Example of closed and open states for a tooltip

Icon tooltip

ClassPropertyColor token
Trigger iconbackground-color$icon-primary
Containerbackground-color$background-inverse
Textcolor$text-inverse

Definition tooltip

ClassPropertyColor token
Labelcolor$text-secondary
Dotted underlineborder-bottom$interactive
Containerbackground-color$background-inverse
Textcolor$text-inverse

Typography

Tooltip labels and text should be set in sentence case.

PropertyFont-size (px/rem)Font-weightType token
Label12 / 0.75Regular / 400$label-01
Body copy14 / 0.875Regular / 400$body-short-01

Structure

All tooltip types have a varying height based on the amount of content they contain.

Interactive tooltip

ElementPropertypx / remSpacing token
Containermax-width240 / 15–
padding16 / 1$spacing-05
margin-top8 / 0.5$spacing-03
Trigger iconheight, width16 / 1–
margin-left8 / 0.5$spacing-03
Structure and spacing measurements for an interactive tooltip

Structure and spacing measurements for an interactive tooltip | px / rem

Definition tooltip

ClassPropertypx / remSpacing token
Containermax-width176 / 11–
padding-top, padding bottom8 / 0.5$spacing-03
padding-left, padding-right16 / 1$spacing-05
Underlineborder-bottom1px–
Caretmargin-top4px$spacing-02
Structure and spacing measurements for a definition tooltip

Structure and spacing measurements for a definition tooltip | px / rem

Icon tooltip

ClassPropertypx / remSpacing token
Containermax-width176 / 11–
padding-left, padding-right16 / 1$spacing-05
padding-top, padding-bottom2 / 0.125$spacing-01
Caretmargin-top8 / 0.5$spacing-03
Structure and spacing measurements for an icon tooltip

Structure and spacing measurements for an icon tooltip | px / rem

Placement

Tooltips should be placed below the tooltip icon unless it is within the height of the tooltip box plus 16px / 1rem of the bottom of the page. In that instance, the tooltip should appear above the icon or defined word. On mobile, tooltips can only appear below the tooltip icon.

Placement examples for a tooltip

Placement examples for a tooltip