---
schema_version: "1"
id: 7f306334be638fbf7aec694c382cf6eb00946b40ab150c515691ee2ad9629889
title: messaging:emailHeader
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/salesforce-pages-developers-guide/guides/pages/components/pages-compref-messaging-emailheader.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/guide/pages-compref-messaging-emailheader.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 53cfff05552d103364a0ebc4e8fcf1521113d20e3868420b75ad2d6f2709c6e3
products:
  - Visualforce Developer Guide
  - Platform Developer Content
---

# messaging:emailHeader

Adds a custom header to the email. The body of a header is limited to 1000 characters.

## Example

```apex
<messaging:emailTemplate recipientType="Contact"
	relatedToType="Account"
	subject="Testing a custom header"
	replyTo="support@acme.com">
            
	<messaging:emailHeader name="customHeader">
		BEGIN CUSTOM HEADER
		Account Id: {!relatedTo.Id}
		END CUSTOM HEADER
	</messaging:emailHeader>
            
	<messaging:htmlEmailBody >
	<html>
	<body>
            
	<p>Dear {!recipient.name},</p>
   	<p>Check out the header of this email!</p>
	</body>
	</html>
	</messaging:htmlEmailBody>
</messaging:emailTemplate>
```

The example above renders the following HTML:

```html
Date: Thu, 5 Feb 2009 19:35:59 +0000
From: Admin User <support@salesforce.com>
Sender: <no-reply@salesforce.com>
Reply-To: support@acme.com
To: "admin@salesforce.com" <admin@salesforce.com>
Message-ID: <19677436.41233862559806.JavaMail.admin@admin-WS>
Subject: Testing a custom header
MIME-Version: 1.0
Content-Type: multipart/alternative;
boundary="----=_Part_8_14667134.1233862559806"
X-SFDC-X-customHeader: BEGIN CUSTOM HEADER Account Id: 001x000xxx3BIdoAAG END CUSTOM HEADER
X-SFDC-LK: 00Dx000000099jh
X-SFDC-User: 005x0000000upVu
X-Sender: postmaster@salesforce.com
X-mail_abuse_inquiries: https://salesforce.com/company/abuse.jsp
X-SFDC-Binding: 1WrIRBV94myi25uB
X-OriginalArrivalTime: 05 Feb 2009 19:35:59.0747 (UTC) FILETIME=[F8FF7530:01C987C8]
X-MS-Exchange-Organization-SCL: 0
```

## Attributes

|Attribute Name|Attribute Type|Description|Required?|API Version|Access|
|--------------|--------------|-----------|---------|-----------|------|
|`id`|String|An identifier that allows the emailHeader component to be referenced by other components in the page.| |14.0|global|
|`name`|String|The name of the header. Note: X-SFDC-X- is prepended to the name.|Yes|14.0||
|`rendered`|Boolean|A Boolean value that specifies whether the component is rendered on the page. If not specified, this value defaults to true.| |14.0|global|

**See Also**  


-   [Visualforce Email Templates](https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/email-and-templates/pages-email-templates-intro.md)