Your space sends a number of emails automatically — a welcome message when someone registers, a reminder before a contest, a note when a penalty is applied. Each of them has a key, and a template you write in Content → Emails replaces the platform's default wording and design for that key. Writing templates needs permission to change content.
The Emails tab lists only the templates your space has defined. Every system email you have not overridden simply uses the built-in default and does not appear here.
Open Content → Emails and press Create template.
Enter the Key of the email you are replacing, exactly as it appears in the table below.
Write the Subject. It is required, and it is itself a template, so it can contain variables.
Write the Content — the HTML body, in a code editor with HTML highlighting, with the preview beside it.
Save.
From then on, that email goes out in your wording. Delete the template and the email falls back to the built-in default again.
There is no test send from the console. The preview is the only check you get before the email reaches somebody, so read it carefully — and note that it renders the HTML in isolation from the console's own styling, allows only a restricted set of tags and attributes, and leaves links inert. Anything outside that set is stripped from the preview.
You do not need to write a footer. One naming the space and offering the unsubscribe link is appended to every email automatically.
Subject and content are templates in Go's syntax: {{ .variable_name }}. Values are HTML-escaped as they are inserted. For a value that is already HTML — a rendered reason or description — write {{ html .variable_name }} instead, which inserts the markup after stripping scripts, event handlers and javascript: links.
Every template can use:
Variable | What it holds |
|---|---|
| The space sending the email |
| The recipient |
| The recipient's custom member attributes, keyed by attribute key |
| Present for the email types a recipient is allowed to unsubscribe from |
Each system email adds its own variables, listed below.
Key | Sent when | Extra variables |
|---|---|---|
| A new account is registered and needs to confirm its address |
|
| An address is added or changed and needs confirming |
|
| A password recovery is requested |
|
| A penalty is applied to a member |
|
| Credits are granted to a member |
|
| A participant is reminded of an upcoming contest |
|
| A participant is disqualified |
|
| A member's comment is deleted with a reason |
|
| A problem suggestion is filed |
|
| A problem suggestion is accepted |
|
| A problem suggestion is declined |
|
A key is lower-case letters, digits and - _ . /, starting with a letter or a digit, up to 255 characters. The same key can hold a template per language — see the translation dropdown on the template's screen.
Keys are not limited to the list above. An automation rule can send an email using any key, including one your space makes up for its own purposes, which is how you send a message the platform has no system email for.
Account emails — address confirmation and password reset — go out even to addresses that have not been verified yet, because verifying is what they are for. Every other type is sent only once the recipient's address is verified, and each one counts against your space's email allowance. See Quotas and limits.
Bulk mail you write and send yourself is a different feature and is not an email template; see Newsletters.