Back to Support Content and Media Blocks List Block

List Block

Use the List block to organize text in numbered or bulleted lists. This guide will show you how to write lists in the WordPress editor.

Add the List Block

To add the List block, click the + Block Inserter icon and search for “list”. Click it to add the block to the post or page.

Alternatively, you can quickly start a numbered list by typing 1. and then a space. To quickly start a bulleted list, type * or - and then a space. When typing these commands on a new line, it will automatically create a List block.


Using your keyboard, you can also type /list on a new line and press enter to quickly add a new List block.

The option to type /list to show the block selector drop-down and chose list from the menu.
Insert a List block by typing /list on a new line.

For more information, visit our detailed instructions on adding blocks.

Convert Existing Text to a List

You can change any text-based block (such as a Paragraph or Heading block) to a List block by following these steps:

  1. With your mouse, highlight the multiple lines of text.
  2. Click on the leftmost button in the toolbar to open the Transform To menu.
  3. Select List. Each separate line of text will be transformed into an item in a list:
Using the Transform to option on several paragraphs to convert the content to a list.

Finish a List

When writing a list, you can press the Enter/ Return key on your keyboard to create a new list item.

To end a list and return to normal text, press the Enter/ Return key twice — the first press will create a new empty list item, but the second press will remove that and start a new Paragraph block instead.

Ending a list with the Enter/ Return key

Block Toolbar

When you click on the block, a toolbar of options will appear above it:

The toolbar that appears above the List block.
The List block toolbar

The List block has the following options in its toolbar:

List Type

A List block can be an unordered list (using bullet points) or an ordered list (using numbers.) Lists can also have mixed orderings, such as numbers followed by bullets or vice versa, by selecting the desired list type in the toolbar:

You can mix lists.
Indent a List Item

You can use the indent option in the toolbar to nest a list item underneath the one above it. You can also press the space bar on your keyboard (with your cursor at the beginning of the list item) to indent an item.

The indent icon highlighted.
Indented list items

Once a list item is indented, you can outdent it again using the toolbar option to the left of the indent icon, or press the backspace key on your keyboard.

More Text Formatting Options

The additional options for text formatting in the List block are:

  • Footnote
  • Highlight (text color)
  • Inline code
  • Inline image
  • Keyboard input
  • Language
  • Strikethrough
  • Subscript
  • Superscript
  • Underline
  • Uppercase

You can use the above options to apply formatting to your text or a set of characters in a List block. To do so:

  1. Highlight the words or characters you’d like to apply the formatting to.
  2. Select the desired option from the toolbar to apply.
List block more options menu

Use the Highlight option to change the color of a few specific words or characters, or set a colored background behind specific words or characters in a list.

  1. Select the text you’d like to format.
  2. Click the downward arrow in the block toolbar.
  3. Click Highlight.
  4. A small window with color options for Text and Background will pop up. This shows a set of predefined color options to choose from, as well as a color picker where you can choose the specific color you want.

Block Settings

When you select a block, you will find additional block settings in the right sidebar. If you do not see the sidebar, you may need to click the Settings icon in the top-right corner to bring up the settings. This icon looks like a square with two uneven columns:

The settings icon in the Editor with a tooltip "Settings" below it.
Click the Settings icon to open the block settings

The List block includes the following settings:

Ordered List Settings

When working with an ordered (i.e., numeric) list, you’ll find additional options in the block settings sidebar.

You can select the Start value for the list to set your list to begin from a number other than 1. This option is useful if you need to insert non-list content into your list (like an image) and continue the numeric list below.

Choose from the following numbering style options:

  • Uppercase letters
  • Lowercase letters
  • Uppercase Roman numerals
  • Lowercase Roman numerals

Use Reverse list numbering to reverse the order of your list. For example, if you wanted to create a countdown list that started with 10, you would use this option.

Numbered list block settings.
Ordered list settings.

Was this guide helpful for you?

Not quite what you're looking for? Get Help!

Copied to clipboard!