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
- While editing your email template, click theย “+”ย button to add a new block
- Search forย “List”ย or find it in theย “Text”ย category
- Click to insert the block
- 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
- Click inside the list block
- Type your list item text
- Press Enter to create a new list item
- Continue adding items as needed
Nested Lists
Create sub-lists within list items:
- Place cursor at the end of a list item
- Press Enter to create a new item
- Press Tab to indent and create a nested list
- 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
- Appropriate List Type: Use ordered lists for sequences, unordered for general items
- Consistent Formatting: Keep list item formatting consistent
- Readable Spacing: Use adequate line height for readability
- Clear Items: Write clear, concise list items
- Nested Lists: Use nested lists sparingly for better email client compatibility
- 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
- Step one
- Step two
- 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