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.

In order to add a List Block, click on the add block button and select the List Block.

You can also type /list and hit enter in a new paragraph block to add one quickly.

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.

The List View is open and the List Block is selected. Four inner List Item blocks are inside the List Block.

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.

The List Block shows these standard buttons:

  • Transform to
  • Block moving tools
  • Unordered list
  • Ordered list
  • Indent
  • More options
The List Block Toolbar.

The List Item shows the following buttons:

  • Block moving tools
  • Outdent list item
  • Indent list item
  • Bold
  • Italic
  • Hyperlink
  • More rich text controls
  • More options
The List Item Toolbar with options for moving, indenting, outdenting, bold, italic and linked text.

Transform to

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

The List Block Transform modal.

Block moving tools

The List Block moving handles in the Toolbar.

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

Detailed instructions on moving a block within the editor can be found here.

Unordered list

The List Block unordered list option in the Toolbar.

An unordered list typically is a bulleted list of items. You can use unordered list where you do not need to display items in any particular order.

An example of unordered list.
An example of unordered list

Ordered list

The List Block ordered list option in the Toolbar.

An ordered list typically is a numbered list of items. You can use ordered list where you need to display items in a particular order.

An example of ordered list.
An example of ordered list
You can indent and outdent one or multiple List Items using the toolbar or keyboard commands.

Outdent list item

The List Item outdent Toolbar option.

Select the List Item. You can use the Outdent list item option or Backspace key on your keyboard to decrease the indentation level of a list item.

Indent list item

The List Item indent Toolbar option.

Select the List Item. You can use the Indent list item option or Space key on your keyboard to increase the indentation level of a list item.

Bold

The List Item Toolbar option for bold text.

You can select the text of a list item and use the Bold option or Ctrl+B / Cmd+B on your keyboard to bold it, which is usually heavier than the surrounding text.

Italic

The List Item Toolbar option for italic text.

You can select the text of a list item and use the Italic option or Ctrl+I / Cmd+I on your keyboard to italicize it, which usually appears slanted to the right.

Hyperlink

The List Item Toolbar option for linked text.

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.

More rich text controls

More rich text controls

Highlight

Use the Highlight option to change the color of the selected text and its background.

Inline code

Use the Inline code feature to format code snippets within your text differently. Not only that, but Inline code formatting also prevents the code to be executed instead of displayed.

Inline image

The Inline image feature allows you to add an image to your block. It has one option: enter the desired pixel width for your image.

Keyboard Input

The Keyboard Input option allows you to add the <kbd> tag to selected text.

Strikethrough

Use the Strikethrough option to place a horizontal line through the middle of the selected text.

Example: Heading Block

Subscript

Use the Subscript option to set the selected text slightly below the normal line of type.

Example: Heading Block

Superscript

Use the Superscript option to set the selected text slightly above the normal line of type.

Example: Heading Block

More options

Below is the list of options under the More options menu for the List Block.

More options in the List block

Details about More options can be found in this support article.

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 the cog icon next to the Publish or Update button.

The block settings sidebar.

Ordered list settings

The List Block settings for ordered lists.

If you choose a numbered list, 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.

Set a stater value for the ordered list in the block settings sidebar.

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

Reverse the list numbering for the ordered list in the block settings sidebar.

Color

The List Block provides Color settings options to change the text, background, and link colors.

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

Dimensions

The List Block provides dimension settings options to add padding and margin.

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.

The advanced section of the block settings sidebar has two input fields for the HTML Anchor and Additional CSS classes.

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.

Changelog

  • Updated 2022-11-29
    • Updated sidebar screenshots
    • Linked to Color, Dimension, and Typography overview pages and removed content from here
    • Linked to More options page and removed content from here
    • Updated the More rich text controls screenshot and content.
  • Updated 2022-11-01
    • Added information about the list item block.
    • Screenshots and updates as per WordPress 6.1.
  • Updated 2021-02-27
    • Added Typography option
  • Updated 2020-12-06
    • Added Color settings in Block Settings
  • Updated 2020-09-24
    • Screenshots and video as per WordPress 5.5
    • Added feature changes in Block Toolbar
    • Added feature changes in Block Settings
  • Updated 2020-06-18
    • Added “Go back to the list of Blocks” to the top of the page
  • Created 2019-03-07

Was this article helpful? How could it be improved?

First published

Last updated