Skip to main contentCarbon Design System

Link

The following page documents visual specifications such as color, typography, structure, and size.

Color

ElementPropertyColor token
Linktext-color$link-primary
Iconsvg$link-primary
Examples of link and inline link

Interactive state color

ElementStatePropertyColor token
Link textHovertext-color$link-primary-hover
Focustext-color$link-primary
Activetext-color$text-primary
Visitedtext-color$link-visited
Disabledtext-color$text-disabled
IconHoversvg$link-primary-hover
Focussvg$link-primary
Activesvg$icon-primary
Visitedsvg$link-visited
Disabledsvg$icon-disabled
BorderFocusborder$focus
Activeborder$focus
Examples of link and inline link states

Typography

There are three sizes for links: small, medium, and large.

ElementFont-size (px/rem)Font-weightType token
Small12 / 0.75Regular / 400$helper-text-01
Medium14 / 0.875Regular / 400$body-compact-01
Large16 / 1Regular / 400$body-compact-02
Examples of link sizes

Structure

There are three link sizes—large, medium, and small. However, the width of a link is determined by the length of the link’s text.

Links can be grouped vertically or horizontally. The following specs are not developed for the link component but are recommended by design as the proper distance between grouped links.

ElementPropertypx / remSpacing token
Link textpadding-right16 / 1$spacing-05
padding-bottom4 / 0.25$spacing-02
padding-bottom8 / 0.5$spacing-03
Icon: small and medium linksvg16 x 16
Icon: large linksvg20 x 20
Structure and spacing measurements for Link with icon

Structure and spacing measurements for Link with icon | px / rem

Structure and spacing measurements for Link grouping | px

Structure and spacing measurements for Link grouping | px

Size

There are three fixed heights of links—small (16px), medium (18px), and large (22px).

SizeHeight
Small16 / 1
Medium18 / 1.125
Large22 / 1.375
Sizing applies to both standalone and inline links

Sizing applies to both standalone and inline links

Feedback

Help us improve this component by providing feedback, asking questions, and leaving any other comments on GitHub.