Managing Communication Templates
Last updated: November 18, 2026
Overview

This article will teach you how to edit and create communication templates.
Please read the About customer communications article before going forward if this is your first time working with communications in gaiia.
Templates can only be created and edited by users with the Communication permission enabled
Guide: Customer communication
This article is part of a larger guide going over the concept of customer communication
References
MJML Framework
Before going forward, take note that gaiia's template editor is based on the MJML framework. This framework allows you to quickly and easily create rich email templates using blocks to define your layout.
We highly encourage you to check their Getting started guide, and to keep their documentation open for references while you learn.
Merge tags
To help you customize your communications, you have access to a multitude of merge tags. These tags are used to dynamically insert data into a message before it is sent to a customer.
Merge tags are written in the template like so: {{billingaddress.country}}
For a list of available tags and more information on their usage, please read this article: Merge tags
Steps
Existing templates
Navigate to the Admin menu
Click on the Communication tab
Select the desired template
Select either System messages or Custom messages to alternate between the communication types
Edit the template's details using the
Penbutton located in the upper-right cornerNavigate between Email and SMS to view the related template versions
Select the desired template's translation to open the editor
Alternatively, click on
Create email/SMSif a translation is missingUse the editor to format your template
Use the
Send testbutton to make sure everything is correctly formattedTest emails are sent to your own gaiia email address. Tests of system messages arrive with [TEST] at the start of the subject. For an SMS test, enter the mobile number to send it to.
Click on
SaveMake sure you set the template to Active using the radio button
Repeat from step 6 for all of your supported languages
New templates
Currently, you can only create new templates for Custom messages.
For System messages, you will need to open the existing template and either edit one of the template's translation, or add a new one if it's missing.
Navigate to the Admin menu
Click on the Communication tab
Select the Custom messages tab
Click on
Create messageFollow the instructions to fill in the template's details
Select your newly created template
Navigate between Email and SMS to create the relevant template versions
If your organization hasn't setup an SMS integration, only email is required
Use the editor to format your template
Click on
SaveMake sure you set the template to Active using the radio button
Repeat from step 5 for all of your supported languages
Adding a header and footer to every email
The Global template holds the content added above and below every email that uses it, such as your logo, contact details and legal footer. You set it once instead of repeating it in each template. It applies to emails only, not to SMS or PDF documents.
The global template has a default version, used for every language without its own version. To use different content for a language, click the Customize for button of that language. To go back to the default content, click Use the default version.
A. Create the global template
Open the communication templates settings, where the System messages and Custom messages tabs are.
Select the Global template tab.
Click
Create the global template.Add the content to display above and below your emails, then save.
B. Choose which templates use it
Email templates created after the global template exists use it automatically.
Existing templates don't use it until you turn it on. To turn it on or off for every template at once, click
Activate for allorDeactivate for allon the Global template tab.To turn it on or off for a single template, use the Global template toggle at the top of the template editor. The toggle applies to every language of that template.
Templates that already include their own header or footer show both until you remove one of them, or turn off the global template for that template. Review your templates before you click Activate for all.
If you delete the global template, the templates that use it are sent without a header or footer until you create a new one. Their setting is kept.