---
schema_version: "1"
id: 87fd0b963c884bd3bf3a90aedd46a0e1d5452b3db46aa3b28f1d180d3d995ff1
title: messaging:emailTemplate
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-emailtemplate.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/guide/pages-compref-messaging-emailtemplate.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: fe63e9364e58f33c87687cc4be4ea72564bddea1f05562c56b97346d479f36f8
products:
- Visualforce Developer Guide
- Platform Developer Content
---
# messaging:emailTemplate
Defines a Visualforce email template. All email template tags must be wrapped inside a single emailTemplate component tag. emailTemplate must contain either an htmlEmailBody tag or a plainTextEmailBody tag. The detail and form components are not permitted as child nodes. This component can only be used within a Visualforce email template. Email templates can be created and managed through Setup | Communication Templates | Email Templates.
## Example
```apex
Hello {!recipient.name}--
Here is a list of the cases we currently have for account {!relatedTo.name}:
Cases currently associated with {!relatedTo.name}
{!cx.CaseNumber}, {!cx.Subject}, {!cx.Contact.email}, {!cx.Status}
```
## Translated Template Example
```apex
{!$Label.email_greeting} {!recipient.name}--
{!$Label.email_body}
```
## Attributes
|Attribute Name|Attribute Type|Description|Required?|API Version|Access|
|--------------|--------------|-----------|---------|-----------|------|
|`id`|String|An identifier that allows the emailTemplate component to be referenced by other components in the page.| |14.0|global|
|`language`|String|The language used to display the email template. Valid values: Salesforce-supported language keys, for example, "en" or "en-US". Accepts merge fields from recipientType and relatedToType.| |18.0||
|`recipientType`|String|The Salesforce object receiving the email.| |14.0||
|`relatedToType`|String|The Salesforce object from which the template retrieves merge field data. Valid objects: objects that have a standard controller, including custom objects Visualforce supports.| |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|
|`replyTo`|String|Sets the reply-to email header.| |14.0||
|`subject`|String|Sets the email subject line. Limit: 100 characters.|Yes|14.0||
**See Also**
- [Visualforce Email Templates](https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/email-and-templates/pages-email-templates-intro.md)