60 lines
2.6 KiB
Plaintext
60 lines
2.6 KiB
Plaintext
---
|
|
title: Templates
|
|
description: Create reusable email templates for your campaigns, workflows and transactional emails
|
|
icon: SwatchBook
|
|
---
|
|
|
|
Templates are stored in the Plunk dashboard and can be used in campaigns, workflows and transactional emails.
|
|
|
|
## Designing templates
|
|
|
|
Templates can be created using the built-in editor or by uploading your own HTML.
|
|
|
|
### Personalization
|
|
|
|
You can use contact data to personalize your templates by using the handlebars syntax `{{ key }}`, where `key` is the contact data key.
|
|
|
|
#### Always Available Variables
|
|
|
|
These variables are always available in your templates, regardless of custom contact data:
|
|
|
|
| Variable | Description |
|
|
| -------------------- | -------------------------------------- |
|
|
| `{{id}}` | The contact's unique identifier |
|
|
| `{{email}}` | The contact's email address |
|
|
| `{{unsubscribeUrl}}` | URL to the unsubscribe page |
|
|
| `{{subscribeUrl}}` | URL to the subscribe/resubscribe page |
|
|
| `{{manageUrl}}` | URL to the preferences management page |
|
|
|
|
#### Fallback Values
|
|
|
|
You can provide fallback values for variables that might not be set:
|
|
|
|
```
|
|
Hello {{firstName ?? 'there'}}!
|
|
```
|
|
|
|
If `firstName` is not set, this will render as "Hello there!"
|
|
|
|
#### Special Fields
|
|
|
|
The following fields are reserved by Plunk but can still be used.
|
|
|
|
| Variable | Description |
|
|
| ---------------- | --------------------------------------------------- |
|
|
| `{{subscribed}}` | Contact's subscription status (true/false) |
|
|
| `{{locale}}` | Contact's preferred locale (e.g., 'en', 'fr', 'es') |
|
|
|
|
### Previewing templates
|
|
|
|
You can preview your templates by selecting a contact in the preview window. This will allow you to see how the template will look for that specific contact, with their data populated.
|
|
|
|
## Templates types
|
|
|
|
There are two types of templates in Plunk. Each type is treated at the same priority when sending emails, you should not pick one type over the other based on deliverability or performance.
|
|
|
|
| Type | Description |
|
|
| ------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
| Marketing | Automatically includes a Plunk-hosted unsubscribe page and footer. Will not be sent to contacts who are unsubscribed |
|
|
| Transactional | Does not include any way to unsubscribe. Will be sent to any contact, regardless of subscription state |
|