Documentation

List Block

The List block allows you to create ordered (numbered) and unordered (bulleted) lists in your email templates. Use lists to organize information, create step-by-step instructions, or display items in a structured format.

Adding a List Block

  1. While editing your email template, click theย “+”ย button to add a new block
  2. Search forย “List”ย or find it in theย “Text”ย category
  3. Click to insert the block
  4. Start typing to add list items

Alternatively, you can type * or - followed by a space to quickly create an unordered list, or 1. followed by a space for an ordered list.

List Types

Unordered List (Bulleted)

Creates a bulleted list with no specific order:

  • Use for items that don’t need to be in a particular sequence
  • Default list type
  • Common use cases: Features, benefits, options

Ordered List (Numbered)

Creates a numbered list with sequential order:

  • Use for items that need to be in a specific sequence
  • Common use cases: Steps, instructions, rankings

To Switch Types: Click the list block and use the toolbar to toggle between ordered and unordered.

List Settings

List Type

Choose the numbering or bullet style:

  • Numbers: 1, 2, 3, 4…
  • Letters: a, b, c, d… or A, B, C, D…
  • Roman Numerals: i, ii, iii, iv… or I, II, III, IV…

Start Number

For ordered lists, set the starting number:

  • Default: 1
  • Useful for continuing lists across sections
  • Example: Start at 5 if continuing from a previous list

Reversed

For ordered lists, reverse the numbering order:

  • Numbers count down instead of up
  • Example: 5, 4, 3, 2, 1

Adding List Items

Creating Items

  1. Click inside the list block
  2. Type your list item text
  3. Press Enter to create a new list item
  4. Continue adding items as needed

Nested Lists

Create sub-lists within list items:

  1. Place cursor at the end of a list item
  2. Press Enter to create a new item
  3. Press Tab to indent and create a nested list
  4. Press Shift+Tab to outdent

Formatting List Items

You can format text within list items:

  • Bold: Make text bold
  • Italic: Italicize text
  • Link: Add hyperlinks
  • Inline Code: Display code or technical terms

Styling Options

Typography

  • Font Size: Control the size of list text
  • Font Family: Choose a font family
  • Font Weight: Make text bold or regular
  • Font Style: Apply italic styling
  • Line Height: Control spacing between lines
  • Letter Spacing: Adjust spacing between characters
  • Text Transform: Uppercase, lowercase, or capitalize
  • Text Decoration: Add underline or other decorations

Colors

  • Text Color: Set the color of list text
  • Background Color: Add a background color to the list
  • Link Color: Customize link colors within list items

Spacing

  • Padding: Add internal spacing around the list

Best Practices

  1. Appropriate List Type: Use ordered lists for sequences, unordered for general items
  2. Consistent Formatting: Keep list item formatting consistent
  3. Readable Spacing: Use adequate line height for readability
  4. Clear Items: Write clear, concise list items
  5. Nested Lists: Use nested lists sparingly for better email client compatibility
  6. Mobile-Friendly: Test how lists appear on mobile devices

Examples

Example 1: Feature List

Content: Unordered list of product features

  • Feature 1
  • Feature 2
  • Feature 3

Example 2: Step-by-Step Instructions

Content: Ordered list of instructions

  1. Step one
  2. Step two
  3. Step three

Example 3: Nested List

Content: Main items with sub-items

  • Main item 1
    • Sub-item 1.1
    • Sub-item 1.2
  • Main item 2
    • Sub-item 2.1

Troubleshooting

List Not Displaying

  • Verify the list has items
  • Check that the list block is properly inserted
  • Ensure the block is saved correctly

Numbering Issues

  • Some email clients have limited numbering support
  • Test in multiple email clients
  • Consider using simple numbering (1, 2, 3) for best compatibility

Nested Lists Not Working

  • Some email clients have limited nested list support
  • Test in multiple email clients
  • Consider using flat lists for better compatibility
  • Use indentation carefully

Styling Not Applied

  • Some email clients strip or ignore certain CSS
  • Test in multiple email clients
  • Use inline styles when possible
  • Avoid complex CSS that may not render

Spacing Issues

  • Adjust line height for better spacing
  • Test on mobile devices
  • Some email clients may render spacing differently
  • Use consistent spacing values

Additional resources

Use the links below for more information and guidance on adding blocks. Keep in mind that these articles are general information related to the WordPress Editor and building with blocks. Email Customizer does not utilize all blocks or functionality due to the limited capabilities of emails.

WordPress Editor