Email and SMS Template Tags Reference
This page lists all template tags available when composing email and SMS templates, together with a description of each and an example value.
Template tags are written using the Django Template Language (DTL) by default:
{{ tag }} outputs a value, and {% for item in list %}...{% endfor %} iterates over a list.
Handlebars-format templates use the same {{ tag }} syntax for simple values and
{{#each list}}...{{/each}} for lists.
The tags available in a template depend on the Type (entity) the template is configured for.
Tags available for all template types
These tags are available in every email and SMS template, regardless of type.
| Tag | Description | Example |
|---|---|---|
{{ race.name }} |
The name of the race | 2024 National Championships |
{{ race.status }} |
The current status of the race | accepted |
{{ race.race_date }} |
The date of the race | 15 June 2024 |
The following tags are available in email templates only (not SMS):
| Tag | Description | Example |
|---|---|---|
{{ mailer.name }} |
The name of the platform | Race Entries |
{{ organisation.name }} |
The name of your organisation | British Canoeing |
{{ organisation.subaccount }} |
The name of the subaccount, if applicable | Wales |
{{ organisation.site_url }} |
The URL of your organisation’s site | https://entries.example.com |
{{ organisation.logo }} |
The URL of your organisation’s logo image | /media/logo.png |
Order templates
Order templates are addressed to the person who submitted an order. In addition to the common tags above, the following tags are available.
| Tag | Description | Example |
|---|---|---|
{{ order.id }} |
The numeric ID of the order | 42 |
{{ order.name }} |
The name of the order submitter | Smith, J |
{{ order.paid }} |
Whether the order is paid (True or False) |
True |
{{ order.total_paid }} |
The total amount paid (formatted with currency symbol) | £25.00 |
{{ order.price }} |
The total price of the order (formatted with currency symbol) | £25.00 |
{{ order.payment_type }} |
The payment method used | stripe |
{{ entries }} |
The list of entries in the order (see below) | — |
The entries tag is a list of entries. Each item in the list has the same fields as the
entry tags below. Use a loop to output information for each entry:
{% for entry in entries %}
{{ entry.name }} — {{ entry.race_name }} — {{ entry.number }}
{% endfor %}
Entry templates
Entry templates are addressed to the entry as a whole. In addition to the common tags above, the following tags are available.
| Tag | Description | Example |
|---|---|---|
{{ order.id }} |
The numeric ID of the order | 42 |
{{ order.name }} |
The name of the order submitter | Smith, J |
{{ order.paid }} |
Whether the order is paid (True or False) |
True |
{{ order.total_paid }} |
The total amount paid (formatted with currency symbol) | £25.00 |
{{ order.price }} |
The total price of the order (formatted with currency symbol) | £25.00 |
{{ order.payment_type }} |
The payment method used | stripe |
{{ entry.race }} |
The race class code | K1 |
{{ entry.race_name }} |
The race class name | Kayak Single |
{{ entry.race_class.name }} |
The race class full name | Kayak Single |
{{ entry.race_class.code }} |
The race class code | K1 |
{{ entry.race_class.description }} |
The race class description | Senior Kayak Single |
{{ entry.crew_type.name }} |
The crew type name | K1 |
{{ entry.crew_type.short_name }} |
The crew type short name | K1 |
{{ entry.crew_type.description }} |
The crew type description | Kayak Single |
{{ entry.name }} |
A description of the entry | K1 - Smith, J |
{{ entry.price }} |
The entry price (formatted with currency symbol) | £25.00 |
{{ entry.status }} |
The entry status | Accepted |
{{ entry.paid }} |
Whether the entry is paid (True or False) |
True |
{{ entry.refunded }} |
Whether the entry is refunded (True or False) |
False |
{{ entry.number }} |
The race / start number | 042 |
{{ entry.members }} |
The list of crew members on the entry (see below) | — |
The entry.members tag is a list of crew members. Each item in the list has the same fields as
the crew member tags below. Use a loop to output information for each
crew member:
{% for member in entry.members %}
{{ member.first_name }} {{ member.surname }} — {{ member.club_name }}
{% endfor %}
Crew member templates
Crew member templates are addressed to an individual crew member. In addition to the common tags
above, the following tags are available. The order and entry tags have the same structure as
described in the sections above.
| Tag | Description | Example |
|---|---|---|
{{ order.id }} |
The numeric ID of the order | 42 |
{{ order.name }} |
The name of the order submitter | Smith, J |
{{ order.paid }} |
Whether the order is paid (True or False) |
True |
{{ order.total_paid }} |
The total amount paid (formatted with currency symbol) | £25.00 |
{{ order.price }} |
The total price of the order (formatted with currency symbol) | £25.00 |
{{ order.payment_type }} |
The payment method used | stripe |
{{ entry.race }} |
The race class code | K1 |
{{ entry.race_name }} |
The race class name | Kayak Single |
{{ entry.race_class.name }} |
The race class full name | Kayak Single |
{{ entry.race_class.code }} |
The race class code | K1 |
{{ entry.crew_type.name }} |
The crew type name | K1 |
{{ entry.name }} |
A description of the entry | K1 - Smith, J |
{{ entry.status }} |
The entry status | Accepted |
{{ entry.paid }} |
Whether the entry is paid (True or False) |
True |
{{ entry.number }} |
The race / start number | 042 |
{{ crew_member.full_name }} |
The crew member’s full name | Jane Smith |
{{ crew_member.surname }} |
The crew member’s surname | Smith |
{{ crew_member.first_name }} |
The crew member’s first name | Jane |
{{ crew_member.class_name }} |
The age/gender class code | SJW |
{{ crew_member.club_code }} |
The club code | LVW |
{{ crew_member.club_name }} |
The club full name | Llandaff Canoe Club |
{{ crew_member.division }} |
The ranking division | D1 |
{{ crew_member.date_of_birth }} |
The crew member’s date of birth | 1 January 1990 |
{{ crew_member.membership_number }} |
The membership / licence number | 123456 |
{{ crew_member.membership_expiry }} |
The membership expiry date | 31 December 2024 |
{{ crew_member.membership_type }} |
The membership type | Full |
{{ crew_member.membership_organisation }} |
The name of the membership organisation | British Canoeing |
{{ crew_member.competitor_group }} |
The competitor group name | Senior |
Team templates
Team templates are addressed to a team as a whole. In addition to the common tags above, the following tags are available.
| Tag | Description | Example |
|---|---|---|
{{ team.name }} |
The name of the team | Llandaff A |
{{ team.entered_by_name }} |
The name of the person who entered the team | Smith, J |
{{ team.entered_by_email }} |
The email address of the person who entered the team | j.smith@example.com |
{{ team.entered_by_club }} |
The name of the entering club | Llandaff Canoe Club |
{{ team.status }} |
The team status | Accepted |
{{ team.team_type }} |
The team type | Senior K4 |
Result templates
Result templates are addressed to the entry a race result belongs to. They do not have an
order tag - in addition to the common tags above, the following tags are available.
| Tag | Description | Example |
|---|---|---|
{{ entry.race }} |
The race class code | K1 |
{{ entry.race_name }} |
The race class name | Kayak Single |
{{ entry.race_class.name }} |
The race class full name | Kayak Single |
{{ entry.race_class.code }} |
The race class code | K1 |
{{ entry.race_class.description }} |
The race class description | Senior Kayak Single |
{{ entry.crew_type.name }} |
The crew type name | K1 |
{{ entry.crew_type.short_name }} |
The crew type short name | K1 |
{{ entry.crew_type.description }} |
The crew type description | Kayak Single |
{{ entry.name }} |
A description of the entry | K1 - Smith, J |
{{ entry.price }} |
The entry price (formatted with currency symbol) | £25.00 |
{{ entry.status }} |
The entry status | Accepted |
{{ entry.paid }} |
Whether the entry is paid (True or False) |
True |
{{ entry.refunded }} |
Whether the entry is refunded (True or False) |
False |
{{ entry.number }} |
The race / start number | 042 |
{{ entry.members }} |
The list of crew members on the entry (see crew member tags) | — |
{{ result.number }} |
The competitor’s race / start number | 042 |
{{ result.race_class }} |
The name of the race start (heat or division) the entry competed in | Div1 |
{{ result.elapsed_time }} |
The competitor’s elapsed time for the race, formatted as H:MM:SS |
1:23:45 |
{{ result.position }} |
The competitor’s finishing position within their race class | 3 |
Additional tags for automated action notifications
Some actions on the Entries, Orders and Teams tabs can automatically send a notification email when performed - for example ticking “Send email notifications” when cancelling entries, changing entry status, or renumbering entries. These notifications use a fixed, built-in template rather than one you compose yourself, and some of them add extra tags on top of the order, entry or team tags already documented above.
These extra tags are only available in these automated notifications - they are not available when composing a manual email using the Send Email action’s template picker.
| Action | Where | Type | Additional tags |
|---|---|---|---|
| Cancel Entries | Entries tab | Entry | {{ refund_amount }} — the amount refunded, formatted with currency symbol. Empty if “Refund payments” was not selected. Example: £25.00 |
| Update Status | Entries tab | Entry | {{ new_status }} — the newly assigned entry status. Example: Accepted |
| Renumber Entries | Entries tab | Entry | None - {{ entry.number }} already reflects the newly allocated number |
| Cancel Entries | Orders tab | Order | {{ refund_amount }} — the amount refunded, formatted with currency symbol. Empty if “Refund payments” was not selected. Example: £25.00 |
| Update Status | Teams tab | Team | None - {{ team.status }} already reflects the newly assigned status |