> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-unity-sdk-initialization-split.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Import and Use Template Groups in Email Content

> Simplify multi-locale and multi-variant email creation with MoEngage template groups. Import and manage related templates for efficient campaigns.

## Overview of Template Groups

As a marketer, you often need to create email campaigns for different languages (multi-locale) or with multiple versions to test (multi-variant). For example, if you want to run a campaign for 20 locales, each with two variants, you would normally set up 40 separate content combinations. These combinations are related because they deliver the same core message.

The Template Groups feature in MoEngage helps you manage these related templates efficiently. Instead of manually adding content for every combination, you can group templates that share a common message but differ by locale or variant.

MoEngage allows you to create Template Groups by passing the *locale*, *variant*, and *group\_id*  parameters in the [Create Email Template API](https://www.moengage.com/docs/api/email-templates/create-email-template-v2).

When you use Template Groups, MoEngage imports and renders the mapped templates together. Perform the following steps to access template groups while creating email campaigns:

1. Navigate to Step 2: Content.
2. In the **Imported templates** tab, you can view the template groups created using the [Create Email Template API](https://www.moengage.com/docs/api/email-templates/create-email-template-v2). <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/q6SvYhZa4K6FIef8/images/moengage_4424ce.png?fit=max&auto=format&n=q6SvYhZa4K6FIef8&q=85&s=a4dc3a6bde22262f6124f10935de792f" alt="Screenshot 2025-10-08 at 2.50.37 PM.png" width="2562" height="1088" data-path="images/moengage_4424ce.png" />
3. Select a template group, and MoEngage automatically populates content for all locale and variation combinations.

This feature saves you time because you need not add templates manually for all locale and variant combinations. In the above example of 40 combinations, it takes just one click to populate all of the relevant content.

<Info> Template Grouping is currently not supported within the Template Manager.</Info>

## Create and Push a Template Group to MoEngage

If you create your email content outside MoEngage, such as in a Content Management System (CMS), you can push it to MoEngage using the [Create Email Template API](https://www.moengage.com/docs/api/email-templates/create-email-template-v2) of MoEngage. This is useful when you plan to run multi-locale campaigns or conduct A/B tests.

To associate individual templates with a template group, ensure you include the *locale*, *variant*, and *group\_id* parameters when you make the API call. When passing *group\_id* in the API, ensure all templates intended for the same group share the identical *group\_id* value. The *locale* and *variant* parameters then act as unique identifiers to differentiate each individual template within that shared *group\_id*.

## Preview a Template Group

Perform the following steps to preview a template group:

1. In Step 2: Content of the email campaign creation journey, click the  **Imported templates** tab. Template groups can be identified with a badge indicating the total number of variations in the template group. <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/l57Jshi6mIa6WTxy/images/moengage_2cc994.png?fit=max&auto=format&n=l57Jshi6mIa6WTxy&q=85&s=ad3e26a866f6736686658c6bca6e622d" alt="TG-1.png" width="2652" height="1158" data-path="images/moengage_2cc994.png" />
2. Hover the mouse on the thumbnail to see the Preview icon.
   <img alt="Screenshot 2025-10-08 at 3.07.23 PM.png" src="https://mintcdn.com/moengage-unity-sdk-initialization-split/WCD9PHM9QZsnxcgC/images/moengage_e7c0f1.png?fit=max&auto=format&n=WCD9PHM9QZsnxcgC&q=85&s=09efc9ea982cc6e83fd0ccf378150a22" style={{ width:"45%" }} width="552" height="510" data-path="images/moengage_e7c0f1.png" />
3. Click the Preview icon. The Preview template pop-up is displayed. You can view the preview of each template based on its locale and variation.
   <img alt="TG-2.png" src="https://mintcdn.com/moengage-unity-sdk-initialization-split/xyUvu6CpxHU1x9ED/images/moengage_e3e5e0.png?fit=max&auto=format&n=xyUvu6CpxHU1x9ED&q=85&s=5235b1930f8ac3338e07eaebb8aa30c2" style={{ width:"80%" }} width="1642" height="1254" data-path="images/moengage_e3e5e0.png" />
4. From the **Locales** and **Variations** drop-down lists, select the required values to see the associated template. If a locale does not have a variation, the Variations drop-down list is unavailable.
5. Click **Choose and Continue** to add this template group to the email campaign. All templates in the group will get added to the campaign automatically.

## Add a Template Group to Email Campaigns

1. In Step 2: Content, go to the **Imported templates** tab.
2. Hover the mouse on the thumbnail of the required template group.
3. Click the template group to add it to the email campaign. MoEngage automatically creates all locales and all variations within locales, and populates the same on the Step 2: Content page. <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/VIRDnSlIWZ-NqOoJ/images/moengage_17ada5.png?fit=max&auto=format&n=VIRDnSlIWZ-NqOoJ&q=85&s=6184d3e8036e0ba38c4c8f879238919d" alt="TG-3.png" width="2728" height="884" data-path="images/moengage_17ada5.png" /> MoEngage maintains the number of variations consistent across all locales in the template group. If some locales do not have variations, MoEngage adds blank variations in those locales. In that case, the following warning is displayed: <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/gR_3RY7eYNtE0Ioy/images/moengage_a3c84d.png?fit=max&auto=format&n=gR_3RY7eYNtE0Ioy&q=85&s=81dcc25842b72a5765745f33d5ef3392" alt="Gar 4.png" width="552" height="152" data-path="images/moengage_a3c84d.png" /> MoEngage adds warning icons for locales and variations to help you quickly identify that there are blank variations where you must add content. After a template group is added, you can also edit the content of individual templates within the group directly on this page, or re-import updated templates via the Create Email Template API. <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/Ct3koeavD-C_n9RD/images/moengage_dac67a.png?fit=max&auto=format&n=Ct3koeavD-C_n9RD&q=85&s=e5abf39769870792e677f0b2eb3cc0a2" alt="TG-4.png" width="1264" height="540" data-path="images/moengage_dac67a.png" />

## Change a Template Group

To change the selected template group:

1. Click the ellipsis icon next to the **Template actions (custom)** button.
   <img alt="Gar 6.png" src="https://mintcdn.com/moengage-unity-sdk-initialization-split/znxil_H0CDGT_t_k/images/moengage_90100e.png?fit=max&auto=format&n=znxil_H0CDGT_t_k&q=85&s=e1c5085d6406333111757782dfd3e13b" style={{ width:"41%" }} width="420" height="324" data-path="images/moengage_90100e.png" />
2. Click **Change template**. You are back in the **Import templates** tab.
3. Select the required template.

   <Tabs>
     <Tab title="Template Group">
       When you select a template group, the Change template pop-up is displayed, prompting you for confirmation. <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/mKv_oylg_NNQ7Lsq/images/moengage_319664.png?fit=max&auto=format&n=mKv_oylg_NNQ7Lsq&q=85&s=3bb548b31da052ac8c0d526c0888e016" alt="Gar 9.png" width="1338" height="340" data-path="images/moengage_319664.png" /> Click **Add group** to replace all the existing locales and variations with the new group selected.
     </Tab>

     <Tab title="Individual Template">
       When you select an individual template, the Change template pop-up is displayed, prompting you for confirmation. <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/W7uRAsIMAbhvTpo6/images/moengage_046696.png?fit=max&auto=format&n=W7uRAsIMAbhvTpo6&q=85&s=b63562366bbdbde6c708f6dc6346298b" alt="Gar 10.png" width="1566" height="346" data-path="images/moengage_046696.png" />

       1. Click **Replace the group** to replace the whole group.
       2. Click **Update current variation** to add the individual template to the variation template.
     </Tab>
   </Tabs>

## Add a Locale to the Email Campaign

1. Click **+ Locale** to select another locale. A dialog box is displayed where you can search all locales in the system.
   <img alt="TG-5.png" src="https://mintcdn.com/moengage-unity-sdk-initialization-split/AGphINogzEr7dJkJ/images/moengage_dfd6de.png?fit=max&auto=format&n=AGphINogzEr7dJkJ&q=85&s=fe456a4e8288cd5d0d4c89e68483e8c4" style={{ width:"62%" }} width="540" height="374" data-path="images/moengage_dfd6de.png" />
2. Select the required locales and click **Add**. The **Choose content for new added locales** pop-up is displayed. <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/Hp4VPgqtcEH1RPOv/images/moengage_fc512e.png?fit=max&auto=format&n=Hp4VPgqtcEH1RPOv&q=85&s=1f24c4f5e1bdf5d9d409d7255b96c262" alt="TG-6.png" width="1144" height="660" data-path="images/moengage_fc512e.png" />
3. For each locale, from the **Choose locale content from** drop-down list, select the locale content from the following options:
   * Create new content
   * Copy from locale Default
   * Copy from locale `<name>`
4. Click **Done**. To make the number of variations consistent across locales, MoEngage adds blank variations for the newly added locales. You must add content before proceeding to the next step.

<Info>
  To add a new locale to the MoEngage system, click **+ Locale** on the **Imported templates** tab and then click **+ New Locale**.
</Info>

## Add or Remove a Variation

1. Click **+ Variation** to add a variation to a locale. A pop-up window is displayed. <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/cCVRNbpzxfVeActK/images/moengage_7c92f5.png?fit=max&auto=format&n=cCVRNbpzxfVeActK&q=85&s=9c5ef3e996f209adfbc3692a661ed2e4" alt="Gar 13.png" width="708" height="304" data-path="images/moengage_7c92f5.png" />
2. Choose one of the following options:
   * Click **Copy Variation `<number>`** to copy an existing variation with its content in the selected locale. MoEngage adds the copied variation to all other locales in the template group.
   * Click **+ New Variation** to add a new variation. MoEngage adds this blank variation to the selected locale and all other locales in the template group. You must add content before proceeding to next step.
3. To remove a variation, click the delete icon on the variation to be removed. <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/lyl829Ibss13DAHw/images/moengage_21e719.png?fit=max&auto=format&n=lyl829Ibss13DAHw&q=85&s=300a1e362a3d83801c8b7a79d8c4923f" alt="TG-7.png" width="1054" height="286" data-path="images/moengage_21e719.png" /> MoEngage removes the variation from the selected locale and all other locales.

## Copy Email Addresses to All Variations

You can copy the Sender name, From email address, and Reply-to email address from the default variation of the default locale to all other combinations.

1. Click the ellipsis icon next to the **Template actions (custom)** button. A shortcut menu is displayed.

<img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/WCD9PHM9QZsnxcgC/images/moengage_e96bdd.png?fit=max&auto=format&n=WCD9PHM9QZsnxcgC&q=85&s=abfbf7aa2a5618bbb4dbf2c015db84c6" alt="Gar 14.png" style={{ width:"31%" }} width="394" height="312" data-path="images/moengage_e96bdd.png" />

2. Click **Copy to all variations**. This copies the Sender name, From email address, and Reply-to email address from the default variation of the default locale to all other combinations.

## Related Articles

Continue with [email campaign creation](/user-guide/campaigns-and-channels/email/create/create-an-email-campaign).
