Overview
List-ID headers are specialized email headers that uniquely identify a mailing list. They are primarily used by email clients to recognize, filter, and organize messages that belong to the same list. Although end users typically do not see this header, it plays an important role in how inboxes categorize and handle incoming emails.
Key Characteristics
Purpose: Helps email clients group and categorize messages from the same mailing list, for example, into tabs such as Promotions, Social, or Primary.
Client behavior: If a recipient manually moves an email with a specific List-ID to another inbox category, future emails with the same List-ID are automatically placed there.
Visibility: The List-ID header is usually hidden from recipients but is processed by email clients in the background.
List-ID Syntax
The List-ID header consists of two parts:
Description (optional)
A plain text name that describes the mailing list. This part appears before the identifier.List-ID (mandatory)
A unique identifier in the format<list-label.domain>, where:list-labelis a unique string that identifies the mailing list.domainis the domain associated with the mailing list.
Example
For a newsletter, both the description and the label might be “Newsletter”:
List-ID: Newsletter <newsletter.companydomain.com>
This structure ensures that email clients can correctly recognize and process messages from the same mailing list.
Configuration and Behavior
When creating customized List-IDs, the following rules apply:
Domain restrictions: The domain used in the List-ID must meet the same requirements as domains used in the From address. Only verified domains should be used, especially when sending through systems such as Mapp Engage.
Formatting: The List-ID value must always be enclosed in angle brackets
< >to ensure correct recognition by email clients.
Following these guidelines helps ensure that emails are reliably categorized and consistently handled by recipients’ inboxes.