---
title: "Email headers"
source: https://dev.pageseeder.com/guide/configuration/emails/headers.html
description: "This document explains how to configure custom email headers in PageSeeder using HTML `<title>` and `<meta>` elements to customize subject lines, sender information, recipient addresses, and mailing list properties."
last_updated: 2026-08-11T16:00:20+10:00
tokens: ~495
---

# Email headers

This document explains how to configure custom properties and headers for HTML email.

Custom headers are **not required,** and if none are specified in the templates, PageSeeder uses the default settings.

> **Note:** Custom headers apply to HTML messages only, not text-format email.

## HTML `<title>`

Change the `<title>`element in the HTML `<head>`element, to update the message subject (the “Subject” field).

For example:

```xml

<html>
  <head>
    <title>My custom email subject</title>
  </head>
  ...
</html>
```

## HTML `<meta>`

To create custom properties, modify the content of the`<meta>` element in the HTML `<head>` element.

For example:

```xml

<meta name="sender-name"   content="John Smith" />
<meta name="sender-email"  content="jsmith@pageseeder.com"/>
```

### Supported headers

Following is a summary of what \<`meta>` elements can support:

| Name | Description |
| --- | --- |
| `to-email` | Changes the destination address (the “To” field) |
| `from-name` | Changes the originator name in “From” (`from-email`must be set) |
| `from-email` | Changes the originator address in “From” |
| `sender-name` | Changes the originator name in “Sender” (`sender-email`must be set) |
| `sender-email` | Changes the originator address in “Sender” |
| `replyto-name` | Changes the destination name in “Reply-To” (`replyto-email` must be set) |
| `replyto-email` | Changes the destination address in “Reply-To” |
| `list-name` | Changes the identification name in “List-Id” (`list-id` must be set) |
| `list-id` | Changes the ID in “List-Id”, setting this adds the header “Precedence” with a value of “List”. |
| `list-help` | Sets the “List-Help’ email field |
| `list-unsubscribe` | Sets the “List-Unsubscribe“ email field |
| `list-post` | Sets the “List-Post“ email field |
| `list-archive` | Sets the “List-Archive“ email field |
| `message-id` | Sets the “Message-ID“ email field |
| `in-reply-to` | Sets the “In-Reply-To“ email field |

