Carbon Design System

List

Stable
Last updated Sep 30, 2026
Carbon Core

    Lists are vertical groupings of related content, with items organized using bullets or numbers to improve readability and structure.

    List

    What Carbon provides

    Carbon incorporates many accessibility considerations, some of which are described below.

    No accessibility annotations are needed for lists, but keep these considerations in mind if you are modifying Carbon or creating a custom component.

    Keyboard interaction

    Lists are not keyboard operable, unless the list items themselves are operable. In such a situation, the list items will retain the component’s default keyboard interaction. For example, in a list of links, each link will be in the tab order and can be activated by Enter.

    Development considerations

    Keep this in mind if you’re modifying Carbon or creating a custom component:

    • Carbon uses native HTML unordered (ul) and ordered (ol) lists and list items (li), then styles them with CSS.
    • Carbon uses ::before and ::marker CSS pseudo-elements for the numbering and bulleting of lists, which are properly read by assistive technologies such as screen readers.

    Feedback

    Help us improve by providing feedback, asking questions, requesting features, or leaving any other comments on GitHub.