Title: List block
Author: Antonio Villegas
Published: March 7, 2019
Last modified: May 25, 2026

---

# List block

## In this article

 * [How to add the List block](https://wordpress.org/documentation/article/list-block/?output_format=md#how-to-add-the-list-block)
 * [Block toolbar](https://wordpress.org/documentation/article/list-block/?output_format=md#block-toolbar)
    - [Transform to](https://wordpress.org/documentation/article/list-block/?output_format=md#transform-to)
    - [Block moving tools](https://wordpress.org/documentation/article/list-block/?output_format=md#block-moving-tools)
    - [Unordered list](https://wordpress.org/documentation/article/list-block/?output_format=md#unordered-list)
    - [Ordered list](https://wordpress.org/documentation/article/list-block/?output_format=md#ordered-list)
    - [Outdent list item](https://wordpress.org/documentation/article/list-block/?output_format=md#outdent-list-item)
    - [Indent list item](https://wordpress.org/documentation/article/list-block/?output_format=md#indent-list-item)
    - [Bold and italics](https://wordpress.org/documentation/article/list-block/?output_format=md#bold-and-italics)
    - [Hyperlink](https://wordpress.org/documentation/article/list-block/?output_format=md#hyperlink)
    - [More rich text options](https://wordpress.org/documentation/article/list-block/?output_format=md#more-rich-text-options)
    - [More Options](https://wordpress.org/documentation/article/list-block/?output_format=md#more-options)
 * [Block settings](https://wordpress.org/documentation/article/list-block/?output_format=md#block-settings)
    - [Unordered list settings](https://wordpress.org/documentation/article/list-block/?output_format=md#unordered-list-settings)
    - [Ordered list settings](https://wordpress.org/documentation/article/list-block/?output_format=md#ordered-list-settings)
    - [Color](https://wordpress.org/documentation/article/list-block/?output_format=md#color)
    - [Typography](https://wordpress.org/documentation/article/list-block/?output_format=md#typography)
    - [Border](https://wordpress.org/documentation/article/list-block/?output_format=md#border)
    - [Dimensions](https://wordpress.org/documentation/article/list-block/?output_format=md#dimensions)
    - [Advanced](https://wordpress.org/documentation/article/list-block/?output_format=md#advanced)
 * [Changelog](https://wordpress.org/documentation/article/list-block/?output_format=md#changelog)

[ Back to top](https://wordpress.org/documentation/article/list-block/?output_format=md#wp--skip-link--target)

[Go back to the list of **Blocks**](https://wordpress.org/documentation/article/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](https://wordpress.org/documentation/article/list-block/?output_format=md#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.

![A screenshot of block inserter options when /list is typed.](https://wordpress.
org/documentation/files/2019/03/list-insterter-2-1.jpg)

Detailed instructions on adding blocks can be found [here](https://wordpress.org/documentation/article/adding-a-new-block/).

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](https://wordpress.org/documentation/article/list-view/).

![The List View is open and the List block is selected. Four inner List Item blocks
are inside the List block.](https://wordpress.org/documentation/files/2019/03/list-
list_view-1.jpg)

## 󠀁[Block toolbar](https://wordpress.org/documentation/article/list-block/?output_format=md#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.](https://wordpress.org/documentation/files/2022/11/61-
listblock-toolbar.png)

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.](https://wordpress.org/documentation/files/2022/11/61-listblock-
listitem-toolbar.png)

### 󠀁[Transform to](https://wordpress.org/documentation/article/list-block/?output_format=md#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.

![The List block Transform to modal.](https://wordpress.org/documentation/files/
2019/03/list-transforms_to-1.jpg)

### 󠀁[Block moving tools](https://wordpress.org/documentation/article/list-block/?output_format=md#block-moving-tools)󠁿

![The List Block moving handles in the Toolbar.](https://wordpress.org/documentation/
files/2022/11/61-listblock-toolbar-move.png)

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](https://wordpress.org/documentation/article/moving-blocks/).

### 󠀁[Unordered list](https://wordpress.org/documentation/article/list-block/?output_format=md#unordered-list)󠁿

![The List Block unordered list option in the Toolbar.](https://wordpress.org/documentation/
files/2022/11/61-listblock-toolbar-unordered.png)

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.](https://wordpress.org/documentation/files/2019/
03/Untitled-111111.png)

An example of unordered list

### 󠀁[Ordered list](https://wordpress.org/documentation/article/list-block/?output_format=md#ordered-list)󠁿

![The List Block ordered list option in the Toolbar.](https://wordpress.org/documentation/
files/2022/11/61-listblock-toolbar-ordered.png)

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.](https://wordpress.org/documentation/files/2019/03/
Untitled-811111.png)

An example of ordered list

You can indent and outdent one or multiple List Items using the toolbar or keyboard
commands.

### 󠀁[Outdent list item](https://wordpress.org/documentation/article/list-block/?output_format=md#outdent-list-item)󠁿

![The List Item outdent Toolbar option.](https://wordpress.org/documentation/files/
2022/11/61-listblock-list-item-outdent-toolbar-1.png)

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](https://wordpress.org/documentation/article/list-block/?output_format=md#indent-list-item)󠁿

![The List Item indent Toolbar option.](https://wordpress.org/documentation/files/
2022/11/61-listblock-list-item-indent-toolbar-1.png)

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](https://wordpress.org/documentation/article/list-block/?output_format=md#bold-and-italics)󠁿

![The List Item Toolbar option for bold text.](https://wordpress.org/documentation/
files/2022/11/61-listblock-listitem-bold.png)

![The List Item Toolbar option for italic text.](https://wordpress.org/documentation/
files/2022/11/61-listblock-listitem-italic.png)

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](https://wordpress.org/documentation/article/list-block/?output_format=md#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.](https://wordpress.org/documentation/article/link-editing/)

### 󠀁[More rich text options](https://wordpress.org/documentation/article/list-block/?output_format=md#more-rich-text-options)󠁿

The drop-down menu to the left of the [More options menu](https://wordpress.org/documentation/article/more-options/)
contains a range of additional rich text editing options such as highlighting, inline
code, strikethrough, and more.

[Read about more rich text editing options.](https://wordpress.org/documentation/article/more-text-editing-overview/)

### 󠀁[More Options](https://wordpress.org/documentation/article/list-block/?output_format=md#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.](https://wordpress.org/documentation/article/more-options/)

## 󠀁[Block settings](https://wordpress.org/documentation/article/list-block/?output_format=md#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 settings icon
next to the Publish or Save button.

![Settings icon](https://wordpress.org/documentation/files/2019/03/list-settings-
6.8-1-269x300.jpg)

### 󠀁[Unordered list settings](https://wordpress.org/documentation/article/list-block/?output_format=md#unordered-list-settings)󠁿

If you choose an unordered list, you can select the symbol style at the beginning
of every list item from Styles.

This is the example when Checkmark is selected.

![unordered list with checkmark](https://wordpress.org/documentation/files/2019/
03/list-unordered-checkmark-6.8.jpg)

### 󠀁[Ordered list settings](https://wordpress.org/documentation/article/list-block/?output_format=md#ordered-list-settings)󠁿

#### 󠀁[List Style](https://wordpress.org/documentation/article/list-block/?output_format=md#list-style)󠁿

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

![List style of Ordered list](https://wordpress.org/documentation/files/2019/03/
list-ordered-liststyle-6.8-300x222.jpg)

#### 󠀁[Start value](https://wordpress.org/documentation/article/list-block/?output_format=md#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](https://wordpress.org/documentation/article/list-block/?output_format=md#reverse-order)󠁿

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

![Ordered list settings](https://wordpress.org/documentation/files/2019/03/list-
ordered-settings-6.8.jpg)

### 󠀁[Color](https://wordpress.org/documentation/article/list-block/?output_format=md#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](https://wordpress.org/documentation/article/colors-settings-overview/)

### 󠀁[Typography](https://wordpress.org/documentation/article/list-block/?output_format=md#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](https://wordpress.org/documentation/article/typography-settings-overview/)

### 󠀁[Border](https://wordpress.org/documentation/article/list-block/?output_format=md#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](https://wordpress.org/documentation/article/border-settings-overview/)

### 󠀁[Dimensions](https://wordpress.org/documentation/article/list-block/?output_format=md#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](https://wordpress.org/documentation/article/dimension-controls-overview/)

### 󠀁[Advanced](https://wordpress.org/documentation/article/list-block/?output_format=md#advanced)󠁿

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

[Learn more about advanced settings](https://wordpress.org/documentation/article/advanced-settings-overview/)

## 󠀁[Changelog](https://wordpress.org/documentation/article/list-block/?output_format=md#changelog)󠁿

 * Updated 2026-05-25 (props to @kjoyner @awetz583)
    - Updated “Advanced” section to refer to new overview page
 * Updated 2026-03-02 (props @milana_cap)
    - Update section about inserting block (props @katmoody)
    - Add Tab to indent/outdent list item (props @paulhhm and @jdy68)
    - Add border and color support (props @ndiego)
    - [Overhaul](https://github.com/WordPress/Documentation-Issue-Tracker/issues/2132)
      for the article.
    - Update screenshots to 6.9 version.
    - Update videos to 6.9 version.
 * Updated 2025-05-04
    - Updated movie and block settings
 * Updated 2023-08-09
    - Replaced the link section with short summary linking to new dedicated page.
 * Updated 2023-06-08
    - Replaced “More rich text options” section with short summary linking to new
      dedicated page for rich text editing options.
 * 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? 󠀁[Cancel reply](https://wordpress.org/documentation/article/list-block/?output_format=md#respond)󠁿

[Log in to submit feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fwordpress.org%2Fdocumentation%2Farticle%2Flist-block%2F&locale=en_US).
If you need support with something that wasn't covered by this article, please post
your question in the [support forums](https://wordpress.org/support/forums/).

First published

March 7, 2019

Last updated

May 25, 2026