Email Templates & Tokens
Both the email subject and body support template syntax: before sending, the module replaces the tokens in the template with the actual submitted content.
System Tokens
| Token | Description |
|---|---|
[UserName] | The submitter's username (empty for anonymous) |
[DisplayName] | The submitter's display name (the user's DisplayName when logged in, otherwise Anonymous users) |
[Email] | The submitter's email address |
[UserRole] | The submitter's roles (when logged in, e.g. Registered Users;Subscribers) |
[SubmitTime] | The submission time |
[SubmitIP] | The submitter's IP address (not stored when Hide IP address is on) |
[CultureInfo] | The culture info at submission (e.g. en-US) |
[Content] | A summary table of all fields — the most used token |
Field Tokens
Use the field's Name (not the Alias) as a placeholder to output that field's submitted value:
Dear [UserName],
We received your submission at [SubmitTime]:
Name: [Name]
Email: [Email]
Message: [Messages]
We will get back to you soon.Note
Field tokens use the field's Name from the field editor (the internal identifier like Messages), not the Alias. Names contain only letters and digits.
Template Examples
Administrator notification
<h3>New form submission</h3>
<p>Time: [SubmitTime]</p>
<p>From: [DisplayName] ([Email])</p>
[Content][Content] renders as a table containing every field (label + value); file upload fields show the file names.
User auto-reply
<p>Dear [Name],</p>
<p>Thank you for your message. We received the following information:</p>
[Content]
<p>We will reply within 1-2 business days.</p>Attachments
For submissions containing file upload fields, the uploaded files can be included as email attachments. Attachment fields show file names only by default.
Field-Level Display Control
Each field editor provides E-mail Template Options to control whether that field's value is included in emails — turn it off to keep the field out of the [Content] table, ideal for password-like sensitive fields.
Layout Tips
- Templates support HTML tags for beautiful HTML emails.
- System tokens and field tokens can be combined freely.
- Since 07.00.00, a switch controls whether emails display fields.
Next Steps
- Email Settings — recipient configuration
- Submission Records — viewing submissions