List-ID

List-ID is an email header that identifies which mailing list a message belongs to, helping clients filter and organize subscription mail.

List-ID is an email header that identifies the mailing list a message belongs to. Email clients, filters, and mailbox providers use it to recognize that a message is part of a recurring stream rather than a one-off send.

What it looks like

A typical header:

List-Id: Product Updates <updates.example.com

The value has a readable label and a stable identifier. Recipients rarely see it, but filters and inbox rules depend on it staying the same from issue to issue.

Why it matters

If someone subscribes to several newsletters from the same company, List-ID lets a mail client or filter tell them apart and file each one. It also sits alongside headers such as one-click unsubscribe as part of a recognizable subscription stream.

When to use it

Use List-ID for recurring mail tied to a recognizable email list: newsletters, product updates, community digests, and announcement streams. One-off transactional messages such as receipts or password resets are not list mail and do not need it.

Common mistakes

Changing the identifier. Once filters key on a value, changing it breaks those rules. Keep the same identifier for the life of the list.

Treating it as a substitute for the basics. List-ID does not replace a clear sender identity, a working unsubscribe path, or list hygiene.

Related terms