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.

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 Item shows the following buttons:
- Block moving tools
- Outdent list item
- Indent list item
- Bold
- Italic
- Hyperlink
- More rich text controls
- More options

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.

Block moving tools

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

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.

Ordered list

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.

Outdent list item

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

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

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

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

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

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.

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.

Ordered list settings

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.

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

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.

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?
Log in to submit feedback. If you need suppport with something that wasn't covered by this article, please post your question in the support forums.