Lists

The Lists component helps organise related items, making content more structured and easy to scan. Lists can be simple bullet points, sets of links, or styled for specific newsletter formats.

Consistent list formatting improves readability and ensures information is accessible across devices and email clients.

When to use

Use a list when you need to:

• Present multiple related items in a clear, structured way
• Highlight navigation or references in a newsletter or update
• Group content by icons, categories or themes
• Provide a quick table of contents or issue summary

When not to use

Avoid lists when:

• A single sentence or short paragraph is sufficient
• The content is highly detailed – use Cards or Features instead for better presentation

Variations

The Lists component offers several layout options to suit different content needs. You can choose from simple unordered lists for basic grouping, link-based lists for navigation, and structured formats for newsletters and reports. Each variation is designed to improve readability and accessibility. Choose the right variation based on whether your list is intended for scanning, linking or presenting structured information across columns.

Design guidance

• Keep list items short and scannable – aim for one line where possible
• Use icons sparingly to support meaning, not just decoration
• Maintain consistent spacing for readability
• Avoid mixing multiple list types in the same email unless it improves clarity