List block

Go back to the list of Blocks

You can use the List block to create a bulleted or numbered list.

How to add the List block

Open the Block Inserter tool by clicking the + Block Inserter button in the top toolbar or in the block editor. Look for the List block by using the search bar, then click the icon to insert it into the editor.

You can also click the Block Inserter (+) icon in the editor and then choose the List block in the pop-up window.

You can also use a (/) slash command by typing /list in the editor.

Detailed instructions on adding blocks.

Each List Item block inside the List block is a block that can be edited and moved. List Items can also be selected in the List View.

List Block toolbar

Every block comes with unique toolbar icons and block-specific user controls that allow you to manipulate the block right in the editor.

Transform to

You can transform the List block into the Paragraph, Heading, Quote, Columns, or Group blocks. You can unwrap list items and replace the list with the individual blocks using the Unwrap option.

Block moving tools

The up and down arrow icons can be used to shift a block up and down in your document.

Get more information about moving a block within the Editor.

Unordered list

Ordered list

More Options

The Options menu represented by three vertical dots on the far right of the toolbar gives you more features such as the ability to duplicate or remove the block.

Read about these and other settings.

List Item block toolbar

Outdent list item

Select the list item. You can decrease the indentation level using the “Outdent list item” option, or by pressing either the Backspace key or Shift+Tab key combination – which provides a convenient way to adjust indentation using keyboard commands.

Indent list item

Select the list item. You can increase the indentation level using the “Indent list item” option, or by pressing either the Space key or the Tab key – which provides a convenient way to adjust indentation using keyboard commands.

Bold and italics

The Bold and Italics formatting options are used to customize the text in the block. You can also use keyboard shortcuts to enable these text formatting:

• Ctrl + B or Command + B to bold the text.
• Ctrl + I or Command + I to italicize the text.

Link

You can select the text of a list item and use the Hyperlink option or Ctrl+K / Cmd+K on your keyboard to add a link to it.

Read about more link editing options.

More rich text options

The drop-down menu to the left of the More options menu contains a range of additional rich text editing options such as highlighting, inline code, strikethrough, and more.

Read about more rich text editing options.

Block settings

Every block has specific options in the editor sidebar in addition to the options found in the block toolbar. If you do not see the sidebar, click on the Settings button next to the Save/Publish button.

List View

The List view tab, represented by three horizontal lines, allows you to re-order single Button blocks within the Buttons block.

Learn more about options and settings available in list view.

Settings

When you select the Social Icons block Settings tab, represented by a gear icon, you can change settings on the List block

If you are using an ordered list, you will see settings for List style, start value, and reverse order. You will see Advanced settings for both ordered and unordered lists.

List Style

If you choose an ordered list, you can select the list style from the List Style dropdown.

Start value

You can select the number your list starts at. This is useful if you want your list to start at a number other than 1.

Reverse order

You can also reverse the numbers of the list to start at the highest number first.

Advanced

The List block provides the following Advanced settings options: HTML Anchor, Additional CSS Class(es), Additional CSS, and Styles.

Learn more about advanced settings

Styles

The Styles tab is represented by a half-filled circle.

Unordered list settings

If you choose an unordered list, you can select the symbol style at the beginning of every list item from Styles. These style options may be different depending on your theme.

Color

The List block provides Color settings options to change the text and background colors

See this guide for more information about changing colors.

Typography

The List block provides typography settings to change the font family, size, appearance, line height, letter case, letter spacing, and decoration.

Get more details about changing typography settings.

Dimensions

The List block provides dimensions settings options to change padding and margin size.

Learn more about dimension controls.

Border

Border settings provide options to control the width and radius for the List block.

Learn more about border & shadow settings.

Individual List item settings

When you choose an individual list item, you can change the following styles: Color, typography, border and advanced. See the links above to learn more.