List
A set of related items, ordered, unordered, or with icons for bullets.
A List groups related items together. It comes in three kinds: unordered with bullets, ordered with numbers, and icon where an icon of your choice stands in for the bullet. The icon list is the one plain WordPress does not give you, useful for feature lists and checkmarked points.
Adding one
- Select the section or container to hold it.
- Open the inserter and search "list".
- Pick the List block, then add your items.
Settings
In the list's own panel. Appearance lives in the shared design panel.
| Setting | What it does | Reach for it when |
|---|---|---|
| Type | Switches between unordered (bullets), ordered (numbers), and icon | Any time; the type determines which controls below are available |
| Icon | Chooses the icon drawn from a font library (FontAwesome by default) | Icon list type; picks the glyph that stands in for the bullet |
| Icon colour | Sets the icon's colour independently of the text | The icon needs to stand out or match a brand colour |
| Icon size | Controls how large the icon is relative to the list text | Larger icons for visual emphasis; smaller for tight inline use |
| Icon spacing | Gap between the icon and the list item text | Tighten or loosen the rhythm between glyph and label |
| Vertical position | Aligns the icon to the top, middle, or bottom of multi-line items | Multi-line items where top-alignment reads better than centred |
| Inline | Lays the list items out in a row instead of a column | Horizontal tag-style lists or breadcrumbs |
| Item spacing | Gap between list items | Breathe out a dense list or compact a sparse one |
| Indent | Left indent of the list relative to its container | Nested context or intentional visual pull from the left edge |
| Start | The number the ordered list begins from | Continuing a list that was interrupted by another element |
| Reversed | Counts down instead of up for ordered lists | Step-down sequences or countdowns |
Styling
The list uses the shared design panel for spacing, type, colour, borders, and effects, each per breakpoint. The icon list has its own colour and size controls in the Settings panel so you can style the glyphs independently of the surrounding text.
Accessibility
Use an unordered list for items without a meaningful sequence and an ordered list when order matters, such as steps. Screen readers announce the list type to the listener, so choosing correctly sets expectations. For icon lists, the icon is decorative; the text item carries the meaning, and nothing extra is needed. Keep item text short enough to scan but specific enough to stand alone out of context.