v3.19.1

Getting Started Devices Gateways Integrations Reference
Get The Things Stack

Reference

    Overview
  • Adaptive Data Rate
  • API
  • Application Packages
  • Billing with Stripe
  • Command-Line Interface
  • Components
  • Configuration
  • Data Formats
  • Data Retention and Privacy
  • Email Templates
    • Available Templates
    • Overriding Templates
  • Federated Authentication
  • Frequency Plans
  • Gateway RTT
  • Glossary
  • ID and EUI Constraints
  • Last Activity
  • LoRa Basics Station Implementation Guide
  • LoRaWAN Backend Interfaces Interoperability
  • LoRaWAN Specification and Regional Parameters
  • Networking
  • Packet Broker Routing
  • Packet Forwarders
  • Purging Entities
  • Rate Limiting
  • Resource Limiting
  • Root Certificates
  • Telemetry
  • Tenant Management
  • Web UI Branding

Overriding Templates

Removed in 3.19

Note:
We recommend getting familiar with the html/template template format first.

Template Components

An email template override has three components:

  1. The subject file, which contains the subject of the email and is named <identifier>.subject.txt.
  2. The text contents file, which contains the contents of the email in text format and is named <identifier>.txt.
  3. The HTML contents file, which contains the contents of the email in HTML format and is named <identifier>.html.

Creating the Overrides

In order to override a template, one must provide all three files as part of the email templates repository and then provide them as part of the configuration.

Let’s consider that we want to override the email that a user receives once they register, the email validation email, which has the identifier validate. We need to create the following files:

  • validate.subject.txt
Please confirm your email address for {{.Network.Name}}
  • validate.txt
Please confirm your email address for {{.Network.Name}}.
Your email address will be used as contact for {{.Entity.Type}} "{{.Entity.ID}}". 

Reference: {{.ID}}
Confirmation Token: {{.Token}}
  • validate.html
Please confirm your email address for {{.Network.Name}}. <br> 
Your email address will be used as contact for {{.Entity.Type}} "{{.Entity.ID}}". <br> <br> 

Reference: {{.ID}} <br> 
Confirmation Token: {{.Token}}

Configuring the Location of the Overrides

Once you have written your overrides, you can configure the Identity Server with their location. For details on the configuration options, see the Identity Server configuration reference.

← Available Templates Federated Authentication →

On this page

  • Template Components
  • Creating the Overrides
  • Configuring the Location of the Overrides

The Things Stack

Getting Started

Devices

Gateways

Integrations

Reference

Contributing

GitHub

Forum

About Us

The Things Network

The Things Industries

About this page

Last changed by Hylke Visser on 12 May 2022.
Remove references to customizable email templates (#861)

Edit on Github