> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# RCS Templates

> Create and customize RCS message templates in MoEngage with Rich Cards or Simple Text formats. Build interactive, reusable campaign content.

# Overview

RCS helps elevate brand trust and increase business engagement. It allows you to send personalized messages and visual media to customers, improve efficiency, and enable automated notifications. You can send RCS messages using **Rich Card** or **Simple Text** message types.

Businesses can communicate with customers interactively through RCS messages created using exciting templates. Templates are pre-designed components that can be easily customized and reused to create RCS messages efficiently. They allow for quick and seamless content creation, saving time and aiding in the development of engaging and visually appealing messages.

For users outside India, template approval is not needed, and sending free-form RCS messages is allowed. Although the use of RCS templates is not mandatory for these users, it is still recommended for the convenience of reusing message content.

<Info>
  The template approval process is required only while sending RCS messages to users in India. These templates are linked with the RCS agents created through your RCS providers.
</Info>

<Info>
  This is an add-on feature. To enable it for your account, contact your MoEngage CSM (customer success manager) or the [support team](/docs/user-guide/contact-support/raise-a-support-ticket-through-moengage-dashboard).
</Info>

# Use Cases

RCS can be used in multiple use cases. To refer to RCS use cases, read [Introduction to RCS](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/rcs/getting-started-with-rcs/introduction-to-rcs).

# Template Management

On the **RCS template management** page, MoEngage allows you to create additional templates, search for existing templates, filter templates, edit, view, duplicate, and delete templates. To manage all your RCS Templates:

1. In the MoEngage dashboard, navigate to **Settings** > **SMS, MMS & RCS** > **RCS template management**.

   <img src="https://mintcdn.com/moengage/iCae3l_a7eOJMTbz/images/moengage_1fed99.png?fit=max&auto=format&n=iCae3l_a7eOJMTbz&q=85&s=0f560851ce4a775b9751fbfc10e53321" alt="template management.png" width="2554" height="1403" data-path="images/moengage_1fed99.png" />
2. On the **RCS template management** page, you can see the following fields:

   | Field                                                      | Description                                                                                                                                                                                |
   | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | **Search template by name, content**                       | Use this search bar to search for templates using their name or content.                                                                                                                   |
   | **Filter** (<Icon icon="bars-filter" iconType="solid" /> ) | Use this additional filter option to filter templates based on **Template Type**, **Provider**, and **Sender profile**.                                                                    |
   | **Add Template**                                           | Click **Add Template** to add templates to your MoEngage account.                                                                                                                          |
   | **Template name**                                          | The **Template name** column in the table lists the names of all the created templates. The template name is a hyperlink; clicking it will redirect you to the template in view-only mode. |
   | **Content**                                                | The **Content** column displays the message added to the content section of the respective templates while creating them. Hover over it to view the entire message.                        |
   | **Template Type**                                          | The **Template type** column mentions if the template is Simple Text or Rich Card.                                                                                                         |
   | **Sender Profile**                                         | The **Sender** **Profile** column mentions the name of the sender profile for each template.                                                                                               |
   | **Provider**                                               | The **Provider** column mentions the name of the provider for each template. (For example, Karix, Gupshup)                                                                                 |

After a template is added, you can manage it according to whether or not an active campaign uses it. You can **View**, **Edit**, **Duplicate**, or **Delete** the template.

<img src="https://mintcdn.com/moengage/tNrQQROY8O0h4yWe/images/moengage_17c6bc.png?fit=max&auto=format&n=tNrQQROY8O0h4yWe&q=85&s=7a56da12cb4a0adbf30f1ee3964a44bb" alt="vedd.png" width="1238" height="664" data-path="images/moengage_17c6bc.png" />

<Info>
  You cannot delete the template if an active campaign is using it, as deleting the template can affect the campaign. Therefore, you should stop the campaign before deleting the template.
</Info>

| Template  Usage                                           | Allowed Template Controls     |
| --------------------------------------------------------- | ----------------------------- |
| If the template is not being used in any active campaign. | View, Edit, Duplicate, Delete |
| If the template is being used in any active campaign.     | View, Duplicate               |

## Add Templates in MoEngage

To add templates in MoEngage, perform the following steps:

1. Navigate to **Settings** > **SMS & RCS** > **RCS template management**. Click **+ Add Template**.

<img src="https://mintcdn.com/moengage/T-dEj4C-7pywzBS3/images/moengage_a1d019.png?fit=max&auto=format&n=T-dEj4C-7pywzBS3&q=85&s=75acb8da11b912d41eddd9282e081d7f" alt="settings rcs.png" width="3012" height="1708" data-path="images/moengage_a1d019.png" />

2. On the Add template page, under the template **Settings** section, enter the following details:

<img src="https://mintcdn.com/moengage/60BzFdXTJDO5dnCb/images/moengage_37793b.png?fit=max&auto=format&n=60BzFdXTJDO5dnCb&q=85&s=c9c2e2b71bda469989a9e5b0109beacb" alt="settin.png" width="1808" height="908" data-path="images/moengage_37793b.png" />

| Field                      | Description                                                                                                                                                                                                |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Select Provider**        | Select the service provider with which you want to send this templated message. (For example, Karix, Gupshup)                                                                                              |
| **Select sender**          | Select the sender associated with the selected provider with which this template is approved. You can add only a single sender. This is the RCS agent that would have been created on the provider portal. |
| **Template Name**          | Enter a name for the template. The name can be up to 100 characters.                                                                                                                                       |
| **Template ID** (Optional) | Enter the template ID. You can find the template ID in the provider's dashboard.                                                                                                                           |
| **Template type**          | Select a template type. MoEngage supports **Simple Text** and **Rich Card**.                                                                                                                               |

<Info>
  The **Template Name** and **Template ID** should match the information in your provider dashboard if you send the RCS message to Indian customers.
</Info>

3. On the Add templates page, under the **Content** section, enter the following details. You can add the content of the message to be conveyed to the customers.

   <Tabs>
     <Tab title="Simple Text">
       A **Simple Text** template is a basic text-only message type that allows for detailed communication without images or videos. It can include a verified checkmark for credibility and your brand's logo for brand recognition. If the **Template type** is set as **Simple Text**, you can add up to eleven actions.\
       The following image illustrates how the **Content** section appears in a **Simple Text** template type.

       <img src="https://mintcdn.com/moengage/vl5cQuPaKeqblz8O/images/moengage_8f9c35.png?fit=max&auto=format&n=vl5cQuPaKeqblz8O&q=85&s=5fefc5239a5aff59c3f77a91e1ee33aa" alt="simple - content.png" width="1370" height="440" data-path="images/moengage_8f9c35.png" />

       | Field       | Description                                                                                                                                                                                                                                                                                                                                                                                               |
       | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
       | **Message** | Enter the exact message added to the template in the provider's dashboard. You can enter up to 2500 characters. The message must communicate the objective to your audience. It can have text and variables. Ensure that the variables consist of only alphanumeric characters, underscore, and curly brackets (for example, `{{v1}}`, `{{custom\_param}}`) for personalization during campaign creation. |

       The following image shows an example of an RCS message that uses the **Simple Text** template.

       <img alt="Simple text template.png" src="https://mintcdn.com/moengage/50ZszvUJB4M_6y_L/images/moengage_ea0778.png?fit=max&auto=format&n=50ZszvUJB4M_6y_L&q=85&s=223bf8d8bcd41a2df0ae75fdf33122ad" style={{ width:"38%" }} width="3293" height="5859" data-path="images/moengage_ea0778.png" />
     </Tab>

     <Tab title="Rich Card">
       A **Rich Card** template type can engage with the audience using visual media. It includes images and videos in addition to text messages. If the **Template type** is set as **Rich Card**, you can add up to four actions.\
       The following image illustrates how the **Content** section appears in a **Rich Card** template type.

       <img src="https://mintcdn.com/moengage/S5VM4C7aiU6sct6c/images/moengage_071100.png?fit=max&auto=format&n=S5VM4C7aiU6sct6c&q=85&s=a554391455a1717d27fb0f6048c68377" alt="rich card - content.png" width="1772" height="1244" data-path="images/moengage_071100.png" />

       | Field                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
       | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
       | **Select card orientation**     | Select the orientation in which you want your rich card to be displayed. The available options are: <ul><li>**Horizontal:** When you select this option, the **Select card alignment** list is enabled.</li><li>**Vertical:** When you select this option, the **Select media height** list is enabled.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
       | **Select card alignment**       | If the **Select card orientation** is set to **Horizontal**, you must select the alignment in which you want to display your rich card. The available options are: <ul><li>**Left**</li><li>**Right**</li></ul> Following are the sample images for horizontal-left and horizontal-right, respectively.  <img alt="horizontal left.png" src="https://mintcdn.com/moengage/ME-DtlELD2N8TrcF/images/moengage_c0a263.png?fit=max&auto=format&n=ME-DtlELD2N8TrcF&q=85&s=000a40f4e405a725df93aae1b026a55b" width="572" height="504" data-path="images/moengage_c0a263.png" /> |
       | **Select media height**         | If the **Select card orientation** is set to **Vertical**, select the media height at which you want to display your rich card. The available options are: <ul><li>**Small**</li><li>**Large**</li></ul> Following are the sample images for vertical-small and vertical-large, respectively.  <img alt="vertical small.png" src="https://mintcdn.com/moengage/-uVFLyK4XoHTd5WE/images/moengage_140289.png?fit=max&auto=format&n=-uVFLyK4XoHTd5WE&q=85&s=aedd13cbbfeb070c14a0a1acc3a6bfac" width="612" height="504" data-path="images/moengage_140289.png" />            |
       | **Select media**                | Select the type of media you want to display on the rich card. The available options are: <ul><li>**Image**</li><li>**Video**</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
       | **Select media type**           | Choose the media type. The available options are: <ul><li>**Static:** Static media are fixed at 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. When you select this option, the **Image/Video source** field is enabled.</li><li>**Dynamic:** Dynamic media are flexible and can be personalized for each campaign or user in that campaign. If the **Select media type** is set to **Dynamic**, you can configure it during campaign creation.</li></ul> <br />.                                         **Note**: While adding media using the URL, the base URL must remain static. You can only personalize the variable components of the URL  using attributes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
       | **Image/Video source**          | If the **Select media type** is set to **Static**, you must specify the **Image/Video source** by uploading it directly from your device or linking it to an external source.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
       | **Card title** (Optional)       | Enter a title for the card. You can add up to 200 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
       | **Card description** (Optional) | Enter a description for the card. You can add up to 2000 characters, including the personalized variables.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

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

       | Content-type | Supported format and file size                                                                                                                                                                                                                          |
       | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
       | **Image**    | <ul><li>The supported file types for uploading an image are `JPG`, `JPEG`, `GIF`, and `PNG`.</li><li>The maximum file size is 2 MB.</li><li>The image must be in a 3:1 aspect ratio and must have an optimal resolution of 1440 x 480 pixels.</li></ul> |
       | **Video**    | <ul><li>The supported file types for uploading a video are `H.263`, `M4V`, `MP4`, `MPEG`, `MPEG-4`, and `WebM`.</li><li>The maximum file size is 10 MB.</li></ul>                                                                                       |

       The following image shows an example of an RCS message that uses the **Rich Card** template.

       <img alt="Rich card template.png" src="https://mintcdn.com/moengage/ME-DtlELD2N8TrcF/images/moengage_c32b83.png?fit=max&auto=format&n=ME-DtlELD2N8TrcF&q=85&s=c59791780edf93da9496776348219f1a" style={{ width:"40%" }} width="3293" height="5859" data-path="images/moengage_c32b83.png" />
     </Tab>
   </Tabs>

4. You can add actions that allows the customers to interact with the brand. There are multiple different types, they can either reply, set a reminder, click to call, or click on URL. On the Add template page, under the **Action** section, enter the following details.

   <Info>
     If the **Template type** is set as **Simple Text**, you can add up to 11 actions; if it is set as **Rich Card**, you can add up to 4 actions.
   </Info>

   <img src="https://mintcdn.com/moengage/fUSb9kG75-iJ0JuL/images/moengage_e69869.png?fit=max&auto=format&n=fUSb9kG75-iJ0JuL&q=85&s=76aa2feca1315bba885d87970e80c734" alt="Action.png" width="1970" height="938" data-path="images/moengage_e69869.png" />

   The following three fields are common, regardless of the actions you choose. The tabs below details which fields are specific to certain actions.

   | Field                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | **Type of action**            | Select the type of action you require. The available options are: <ul><li>**Reply:** Use this option when you want your customers to reply to the sent message with a single click response.</li><li>**Calendar event:** Use this option when you want your customers' calendar app to create an event with the information filled in advance.</li><li>**Dialer Action:** Use this option to open the dialer on the customer’s device.</li><li>**URL Action:** This option allows you to enter a URL to which you want to redirect the customer.</li></ul> For more information on each type of action, refer to the tabs after this table. |
   | **Title**                     | Enter a title for the CTA button. You can personalize the title, allowing you to name it differently for individual customers.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | **Enter suggestion postback** | When the user clicks the RCS message action, the entered value is returned, facilitating additional chat functionalities.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

   <Tabs>
     <Tab title="Reply">
       <img src="https://mintcdn.com/moengage/t9nft78wsoLTI2Nx/images/moengage_2c61cf.png?fit=max&auto=format&n=t9nft78wsoLTI2Nx&q=85&s=a81eadabfa0a6030a6b0be120e885106" alt="reply.png" width="1880" height="862" data-path="images/moengage_2c61cf.png" />
     </Tab>

     <Tab title="Calendar Event">
       <img src="https://mintcdn.com/moengage/rlD8iAX6JQFx0hql/images/moengage_bc6b91.png?fit=max&auto=format&n=rlD8iAX6JQFx0hql&q=85&s=07944c7017b43e89a8b0dd79c80f8c8a" alt="calendar event.png" width="1872" height="1188" data-path="images/moengage_bc6b91.png" />

       | Field                       | Description                                                                                                         |
       | --------------------------- | ------------------------------------------------------------------------------------------------------------------- |
       | **Event title**             | Enter the name of the calendar event.  For example, Financial Planning Masterclass.                                 |
       | **Event description**       | Enter the description of the event.  For example,  Basics of Financial Planning, Retirement Planning, Case Studies. |
       | **Event start date & time** | Select the event start date and time from the calendar.  For example,  17 Mar 2025 10:00 AM.                        |
       | **Event end date & time**   | Select the event end date and time from the calendar.  For example,  17 Mar 2025 11:00 AM.                          |
     </Tab>

     <Tab title="Dialer Action">
       <img src="https://mintcdn.com/moengage/2FjM3dGfEH1CYo8k/images/moengage_63801b.png?fit=max&auto=format&n=2FjM3dGfEH1CYo8k&q=85&s=aa7bf707f80b6e73743b062eb7e91f09" alt="dialer action.png" width="1920" height="1038" data-path="images/moengage_63801b.png" />

       | Field            | Description                                                                                                         |
       | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
       | **Phone number** | In the **Select option** list, select the country code and enter the phone number.  For example,  +91 - 900XXXXXXX. |
     </Tab>

     <Tab title="URL Action">
       <img src="https://mintcdn.com/moengage/QRy8rcYszbTJNwGr/images/moengage_b2d236.png?fit=max&auto=format&n=QRy8rcYszbTJNwGr&q=85&s=7c44e7b0f392b0cc744ff1679c34fb41" alt="url.png" width="1892" height="980" data-path="images/moengage_b2d236.png" />

       | Field   | Description                                                                                                                 |
       | ------- | --------------------------------------------------------------------------------------------------------------------------- |
       | **URL** | Enter the URL where the customers have to be redirected.  For example,  [http://www.example.com/](http://www.example.com/). |

       <Info>
         URL actions are tracked for clicks automatically and can be viewed in Campaign Analytics. Clicks on links contained in the description are also tracked if enabled.
       </Info>
     </Tab>
   </Tabs>

5. After completing all configurations, click **Save**.

The template will be listed on the **RCS template management** page.

### Personalizing RCS content

MoEngage uses a specific personalization format. Always use double curly braces (`{{ }}`) for all personalized fields, including the title, description, CTA titles, and so on.\
If you are creating content on a platform that uses a different syntax, update the variables to use double curly braces before saving the template in MoEngage. Otherwise, the variables will be sent as plain text.\
Ensure that variable names contain only alphanumeric characters, underscores, and curly braces. For example: `{{v1}}`, `{{custom\_param}}`.

For more information, refer to [Personalize RCS Campaigns](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/rcs/personalize-rcs-campaign).

# Next Steps

[Create an RCS Campaign](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/rcs/create-an-rcs-campaign)
