Managing Communication Templates

Last updated: November 18, 2026

Overview

communication_page.png

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

  1. Navigate to the Admin menu

  2. Click on the Communication tab

  3. Select the desired template

    Select either System messages or Custom messages to alternate between the communication types

  4. Edit the template's details using the Pen button located in the upper-right corner

  5. Navigate between Email and SMS to view the related template versions

  6. Select the desired template's translation to open the editor

    Alternatively, click on Create email/SMS if a translation is missing

  7. Use the editor to format your template

  8. Use the Send test button to make sure everything is correctly formatted

    Test 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.

  9. Click on Save

  10. Make sure you set the template to Active using the radio button

  11. 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.

  1. Navigate to the Admin menu

  2. Click on the Communication tab

  3. Select the Custom messages tab

  4. Click on Create message

  5. Follow the instructions to fill in the template's details

  6. Select your newly created template

  7. Navigate between Email and SMS to create the relevant template versions

    If your organization hasn't setup an SMS integration, only email is required

  8. Use the editor to format your template

  9. Click on Save

  10. Make sure you set the template to Active using the radio button

  11. 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

  1. Open the communication templates settings, where the System messages and Custom messages tabs are.

  2. Select the Global template tab.

  3. Click Create the global template.

  4. 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 all or Deactivate for all on 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.