WhatsApp Templates

When you want to send WhatsApp Messages using MoEngage, use the templates that are already approved or whitelisted (directly or by the WhatsApp Service Provider or BSP) by WhatsApp in the MoEngage Platform.

Add Templates to MoEngage



Ensure that you have access to all the approved WhatsApp templates before adding templates to MoEngage. You can access the templates from the BSP Dashboards.

To add your already approved/whitelisted WhatsApp templates in MoEngage, go to MoEngage Dashboard -> Settings -> WhatsApp -> Approved Templates. Click on the "+Template" button in the UI.




MoEngage does not validate your templates when you save them. Hence please make sure that they are matching exactly to your whitelisted templates else your campaign may fail because of template mismatch.

Template Settings


  1. Name (mandatory) - Enter the template name exactly similar to what you have on the BSP side. The name can be up to 100 characters
  2. Service Provider (mandatory) - Choose the service provider from the dropdown (or your BSP) with which you want to send this templated message. Please know that WhatsApp templates are approved on the WABA level which can belong to only 1 BSP. So select the BSP to which the template is approved with
  3. Sender Profile (mandatory) - Choose the sender profile to which this template is approved with. You can select multiple sender profiles if they are from the same BSP and are under the same WABA
  4. Language (mandatory) - It is the language of your template. Should be similar to what you have on the BSP/WSP side
  5. Category (mandatory) - Category of the template. WhatsApp allows sending messages that belong to one of the following categories:


Template Content

Message templates can be of 3 types

  1. Text
  2. Media (Image, Video, Document, Location) and
  3. Interactive (Quick Reply and Call to Action).

They are largely formed from 4 key components viz.

  1. Header,
  2. Body,
  3. Footer and
  4. Buttons.

As supported by WhatsApp, selective fields can be configured as:

Static - Static fields are fixed on the Template level. For example, static images can be used to send the same image in all messages to target users across all campaigns where this template is used.

Dynamic - Dynamic fields are flexible and can be configured during campaign creation. A dynamic image can be used to personalize for each campaign or each user in that campaign.

Dynamic Link Tracking - Dynamic link tracking allows you to track clicks on buttons with Navigation as an action. This is available only for Navigation buttons and for Gupshup as a provider.



Headers are optional and can be of the following types:

  • Text (up to 60 characters, can include 1 placeholder)
  • Image

  • Video

  • Document

  • Location

The non-text header can be static or dynamic. They can use a fixed image or document link or personalized image/document for every user. Dynamic fields will be available for configuration at the time of campaign creation.


Here are supported media types, media formats, and file sizes that MoEngage supports:

Content-Type Supported Format and file size

The supported image types are JPG, JPEG, PNG. The maximum file size is 5MB.


The supported document type is PDF. The maximum document size is 5MB.


The supported file types are MP4, 3GPP. The maximum file size is 15MB.


Body content is required and is a text field only. Bodies can contain up to 1024 characters and can be registered as plain text, or text with placeholders

For Example:

Hi {{1}},

We've received a payment of {{2}}.

Please reply here if you need any help.


The variables {{1}} or {{2}} can be replaced by using the personalization details to personalize the message for your audience


Footers are optional and are a text field only. Footers can contain up to 60 characters.


Buttons are optional and templates can only contain one or the other button type. Button text can be up to 25 characters. The following button types are available:

  • Quick replies - You can have up to three quick reply buttons per message. Predefined replies which are set during template approval
  • Call-to-action - You can have up to two call-to-action buttons per message one for each action. Supported actions are Call a number and Visit a website

Template Management

To manage all your WhatsApp Templates, go to MoEngage Dashboard -> Settings -> WhatsApp -> Approved Templates. Once a template is added, you can manage your templates depending on if they are in use or not by a campaign

Template  Usage Allowed Template Actions
Template not being used inside any campaign View, Edit, Duplicate, Delete

Template being used inside any campaign

View, Duplicate




Was this article helpful?
1 out of 8 found this helpful

How can we improve this article?