List block

Go back to the list of Blocks

Organizing content into lists has just gotten easier. 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 + icon 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 can be found here.

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

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

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.

Hyperlink

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.

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.

Block settings

Unordered list settings

Ordered list settings

Color

Like the paragraph block, the List block has color selection settings in the block’s sidebar settings.

For details refer to this support article: Color settings overview

Typography

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

For details refer to this support article: Typography settings overview

Border

The List block provides border settings options to add border color, width, and radius.

For details refer to this support article: Border settings overview

Dimensions

This block provides various options to adjust its dimensions, such as width and height, allowing you to customize the text layout to ensure visual consistency.

For details refer to this support article: Dimension settings overview

Advanced

The Advanced tab in the List block and List Items lets you add HTML anchor and CSS class(es) to your block.

HTML anchor allows you to make a unique web address for a particular List block. Then, you’ll be able to link directly to a List block of your page.

The Additional CSS class(es) lets you add CSS class(es) to your block, allowing you to write custom CSS and style the block as you see fit.