Skip to main contentCarbon Design System

List

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

Color

Both the unordered and ordered list variants share the same color properties.

ElementPropertyColor token
Itemtext-color
$text-primary
Example of unordered and ordered lists

Example of unordered and ordered lists

Typography

List items should use sentence case, that is, only the first word and any proper nouns are capitalized. In IBM product, use the 14px options below. For IBM.com, use the larger expressive 16px options.

ElementFont-size (px/rem)Font-weightType token
Item14 / 0.875Regular / 400
$body-01
Item: nested14 / 0.875Regular / 400
$body-01
Item (expressive)16 / 1Regular / 400
$body-02
Item: nested (expressive)16 / 1Regular / 400
$body-02

Structure

There are two types of lists: unordered and ordered. Both have the same structural properties.

Unordered lists:

  • Level 1 items are marked with dashes (-).
  • Level 2 items are marked with squares (â–Ş).

Ordered lists:

  • Level 1 items are numbered (1, 2, 3…).
  • Level 2 items are marked with letters (a, b, c…).
ItemPropertypx / remSpacing token
Level 1margin-bottom0–
Level 2margin-bottom0–
Level 2padding-left16 / 1
$spacing-05
Structure and spacing measurements for ordered and unordered lists

Structure and spacing measurements for an unordered and an ordered list | px / rem

Feedback

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