Slowly
The builderBlocks

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

  1. Select the section or container to hold it.
  2. Open the inserter and search "list".
  3. Pick the List block, then add your items.

Settings

In the list's own panel. Appearance lives in the shared design panel.

SettingWhat it doesReach for it when
TypeSwitches between unordered (bullets), ordered (numbers), and iconAny time; the type determines which controls below are available
IconChooses the icon drawn from a font library (FontAwesome by default)Icon list type; picks the glyph that stands in for the bullet
Icon colourSets the icon's colour independently of the textThe icon needs to stand out or match a brand colour
Icon sizeControls how large the icon is relative to the list textLarger icons for visual emphasis; smaller for tight inline use
Icon spacingGap between the icon and the list item textTighten or loosen the rhythm between glyph and label
Vertical positionAligns the icon to the top, middle, or bottom of multi-line itemsMulti-line items where top-alignment reads better than centred
InlineLays the list items out in a row instead of a columnHorizontal tag-style lists or breadcrumbs
Item spacingGap between list itemsBreathe out a dense list or compact a sparse one
IndentLeft indent of the list relative to its containerNested context or intentional visual pull from the left edge
StartThe number the ordered list begins fromContinuing a list that was interrupted by another element
ReversedCounts down instead of up for ordered listsStep-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.

On this page