In-App Editor

Learn how to edit and design In-App campaigns from the CleverTap dashboard.


The In-App editor enables you to add content to pre-built templates or customize and build them. You can select the ready-to-use template of your choice or create a custom HTML template as per your requirements. From the What section in the In-App builder, select the Message Type and click Go to Editor.

The In-App Editor tool displays.

In-App Templates

The following are the four main types of In-App templates for creating engaging and personalized In-App campaigns:

Basic Templates:

Basic Templates are ready-to-use templates that enable you to send tailored and personalized In-App engagements to your mobile users. You can use both text and images with CTAs to send personalized In-App messages basis your business use case.

Using basic templates, you can create the following two types of In-App messages:

Content with Image notifications

These templates allow you to use images in combination with text for effective messaging. You can choose from a range of templates such as Cover, Half Interstitial, Interstitial, Header, Footer, and Alert based on your use case.

Image-only notifications

These templates allow you to send visually engaging images that can quickly capture users' attention and encourage them to engage with the message when they launch the app. When selecting an image only template, you can send a message containing only an image (without CTAs, title, or message).

You can choose from the following four types of Image only notifications:


It is a full-screen notification template that is valuable when the intention is to direct the user's focus toward essential actions, such as requiring them to install a necessary app update.

Half Interstitial

It is a center-aligned image notification template for driving better engagements. You can use this template when you want to gain the user's attention towards a sale or discount.


It is a center-aligned image notification template you can use for driving better engagements on app launch.

Image Interstitial



The Image Interstitial template is available only with CleverTap Advanced and Cutting Edge plans.

This template helps craft personalized In-App messages that seamlessly match your app's aesthetics. You upload an image and elevate the experience by incorporating up to 10 interactive hotspots, each with its own unique actions. For example, you can use this template to create a rewarding offer for your gaming app users. The following image represents a sample In-App campaign for rewarding users using the Image Interstitial template:

Sample In-App Campaign using Image Interstitial Template

Sample In-App Campaign using Image Interstitial Template

The Image Interstitial template primarily comprises the following three elements:

  • Overlay: This element is a middle layer between your In-App message and your app in the background. By default, it is transparent; however, you can select a color of your choice or upload an image to it. Using the Overlay configuration, you can:
    • Opt for a semi-transparent color to softly mask the app in the background, drawing more attention to the in-app message in the foreground.
    • Upload a patterned image to create a captivating, full-screen, layered in-app message experience.
  • Content: It is the core element of the template. Click in the center of a blank device or select the Content option from the Element dropdown to activate it. Further, upload an image (JPG, PNG, or GIF) consisting of all In-App message elements such as background, text, and buttons.
    The editor fits the image within the Content container while preserving its aspect ratio without any cropping. By default, a 10% margin is applied to the Content container. However, you can change that from the Margin field.
  • Buttons: The Image Interstitial buttons are transparent regions that you can place over a Content layer. You can easily move and adjust their size to align with the button elements on the image.

The selection area within the Content Container automatically adapts to various device screen sizes, eliminating the need to create multiple versions for different devices. To see how the image and buttons scale across different aspect ratios, use the dropdown menu with different device viewport sizes located at the top for a preview.


Preview & Test

  • The Preview & Test feature for sending tests on the device is not available for iOS or Android SDK versions lower than 6.0.0 and Unity 3.0.0. If you need to test on a device with a lower SDK version, send the campaign exclusively to the user first, and then recreate and send it to the intended audience.

Guidelines for Template Aspect Ratio and File Size

The following tables include the guidelines that you must keep in mind when creating In-App messages:

Canvas TypeCanvas Aspect RatioSample Image SizesImage Type SupportedImage Sample
CoverFull ScreenScreen ResolutionImage
Interstitial1.78:116:9Image, gif, audio, video
Half Interstitial1.30:13:4Image
HeaderHeight: 1:1
Width: Fit to screen
N/ALogo ImageTitle :parameters]
, Message {
"h-0": "C* Title e",
"h-1": , Message pect Ratio",
Title : "Sample Image, Message [75 Characters
FooterHeight: 1:1
Width: Fit to screen
N/ALogo Image
Image Only Cover
Image Only Half Interstitial
Image Only Interstitial

File Size Guidelines

  • Image: Less than 500 kb.
  • Audio: Less than 5 Mb.
  • Video: Less than 50 Mb.

Message Character Limit

Chinese9 (Approximate)38 (Approximate)


Image Cropping

Due to the multiple phone sizes on both Android and iOS, we will center crop images if the image does not fit the screen resolution.
We scale the image uniformly (maintaining the image's aspect ratio) so that both dimensions (width and height) of the image will be equal to or larger than the corresponding dimension of the phone (minus padding). The image is then center-aligned.

Image Cropping does not apply for Image Interstitial template.


Video Messages

When adding video messages to In-App, ensure an audio track is always present.
If required, insert a blank audio track to the video.

Ratings Template

Marketers can now create feedback-related popups for their mobile app users using the Ratings Template.
They can now create two types of rating templates for gaining feedback from their customers:

  • User Rating Popup - It helps assess how happy your customers are with your services by taking feedback in the form of star ratings.
  • NPS Popup - It enables you to measure the loyalty of your customers by distinguishing them in three categories - Promoters, Passives, Detractors. One can view the NPS performance by navigating to the NPS board available under the Boards section.

The following images represent a sample User Rating Popup and NPS popup in a mobile app.


User Ratings Popup


NPS Popup

Marketers get the complete flexibility to explicitly define the rating scale, style, shape (Star, Heart, Emojis), labels, and the overall content of the popup. One can also choose to add a comment box to get accurate user feedback/comments.


In-App Editor Style

Besides, additional styling, such as configuring the color for the message, question, background, and rating scale is also possible from the editor, as shown in the image above. The In-App notification text fields shown below can be personalized for every user based on specific user property or event property values. To learn more about tracking and monitoring user rating data, refer to Analysing User Rating.


Compose In-App Message

Follow-up Question Templates

A follow-up question to your ratings can provide more insights about the user experience. CleverTap provides the following Follow-up Question templates:

  • NPS with Follow-up Question
  • User Ratings with Follow-up Question

For example, after a user has submitted a rating on your app, you can ask follow-up questions such as What did you like most about us? and provide reply choices such as Variety, Prices, Quality, Customer Service, Delivery Process, and Website Usability. This can help you get more specific feedback to improve your product and services. Following is an image from the in-app editor:

Short Keyword Choices

Short Keyword-Based Choices

You can also list descriptive choices such as, I like the available options and variety, I like the quality and durability of the products, and so on. Following is an image from the in-app editor:

Long Sentence Choices

Descriptive Choices

You can configure the follow-up question from the Web Popup editor with a short keyword-based grid (up to six choices) or a longer sentence-based list (up to four choices).

The label will be the text you want to display to your users. If you want to allow the user to select multiple choices, select Allow multiple selections.

Configure Follow-up Popup

Configure Follow-up Popup



In the case of the User Ratings template, the Notification Clicked event is raised that records the user's clicks on the CTA buttons and the Close button

Lead Generation Template

We know that a significant number of App users may remain anonymous. This poses a challenge to continue engaging with potential customers after they leave your App. A lead generation template can solve this issue.

Integrating a lead generation form into your App lets you get important customer details such as name, email address, phone number, etc. This information is helpful for further communication through channels such as SMS, Email, WhatsApp, and others. This post-visit communication helps stay connected with your audience and opens doors for future business opportunities. You can turn anonymous visitors into loyal customers with your App's CleverTap Lead Generation Template.

Sample Lead Generation Template

Sample Lead Generation Template

Post Submit Actions

When a user submits information on your Lead Generation template:

  • A Notification Clicked event is raised that records the click on the CTA.

  • A custom event named Lead Submitted records the details submitted by the user as of event properties. Following is a sample form image:

Form Submit Actions

Form Submit Actions

Following is a table that records the relevant properties for the fields displayed on the form:

Submitted Event PropertiesSample Property Value
First NameJohn
Last NameSmith
Email ID[email protected]
Phone Number+11234567890
Campaign ID121110987654
  • The user profile is automatically updated with the submitted event properties. For example, the lead generation template can ask for additional details from an anonymous user, such as first name, last name, email, and phone number. His profile will be updated with these details, and now you can identify the user as John Smith.

Lead Generation Template Variants

The following are the two types of Lead Generation templates:

  • Text: You can create a text-only lead generation template to record user information.
  • Image on Top: You can add an image on the top to the lead generation template.

Create the content to record information from your users. The following image displays a preview of the form:

Create Lead Generation Template

Create Lead Generation Template

Select the button style and card positions from the Style tab.

Style Lead Generation Elements

Style Lead Generation Elements

Enter all the required information.

  • Text: Personalize the Title and Description.
  • Media: Add the image URL or upload an image.
  • Input Fields: You can add up to four input fields. Select input fields such as Name, Phone Number, Birthday, or Email Address for the template.

Upto Four Input Fields

  • Buttons: The Close button is selected by default. Add a button name such as Submit or Upload.
  • Subtext: Add subtext such as privacy policy to your lead generation template.
Add Subtext

Add Subtext

The hyperlinked part must be closed between two asterisks. Add the URL where the user will be directed. You can also add a checkbox for your subtext.

Subtext and redirect URL

Subtext and redirect URL

  • Acknowledgement: You can show appreciation to your user by adding an Acknowledgement popup. Select the auto-close timer for the popup.

Select the button style and card positions from the Style tab.

Card Orientation

Card Orientation

Custom Templates

You can use the Custom HTML templates in the In-App editor to add more customization to the In-App messages with Javascript.
Ensure that you select the Include Javascript box to add your custom Javascript.


Custom HTML and Actions


Create Interactive In-App Messages

You can create interactive in-app campaigns such as scratch card campaigns and swipe interaction campaigns using JavaScript.

Using the Custom HTML option, you can use Javascript in the HTML and create deep interactive in-app campaigns by adding the JavaScript code along with the HTML code.

JavaScript-based campaigns are available for versions 3.5.0 and above.

Time to Live (TTL)

You can configure the number of days (or hours) to keep the message on the user's device by setting the time to live.


Time to Live for a Message

The TTL can range from 1 day to 60 days. The default value for TTL is two days. You can define the TTL for a maximum of 28 days. The message on the user's device stays there for the specified TTL, after which it is automatically removed. You can also have Infinite TTL, which means the message will never be deleted from the user's device.


Choosing the Right TTL

You should choose a TTL that resonates with the purpose of your campaign. Some messages need to stay on the user's device for a longer period (coupon codes which are valid for a month) while some should last for a day or two (weekend discount offers).

In-App Editor

Use the In-App editor to craft your In-app campaign with the desired messaging and styling best suited for your business. You can choose from a range of In-App templates. Alternatively, you can also use the Custom HTML option to build your own campaign.

The elements of the editor vary based on the type of template you select for creating your In-App campaign.

The following image represents the Content with image notifications template editor.


In-App Editor for Content with Image notifications

At a high level, the In-App editor has the following two primary sections: Content and Style.


The Content section allows you to define your In-App message's overall text and visual content. Use this section to create engaging, and personalized In-App messages by entering enticing Title and Message. To personalize the message, click the Personalization (@) icon in the Title and Description fields.

Using the Insert image option, you can upload the desired image to make your In-App campaign visually appealing when the app is in Portrait or Landscape mode.

You can choose to add the same image with different form factors or completely different images to give a unique experience on portrait and landscape.

Additionally, you can add up to two CTAs and configure their On Click Action as per your requirement. You can use the following three types of action buttons:

  • Close notification: It closes the notification after a tap.
  • Open URL: A special type of CTA that enables the user to open a deep link for Android or iOS.
  • Custom key-value pairs: The key-value pairs send back custom data when a user clicks the in-app button

You can also configure the number of days (or hours) to keep the In-App message on the user's device by setting the Message Time to Live field as per your use case.


Image Interstitial Template Exception

The elements of the In-App editor for the Image only notifications templates are similar to those of the Content with Image notifications templates except for the Title and Message fields.


The Style section enables you to customize the appearance of your In-App message elements, such as title color, background color, message color, button text color, and so on.

Customize the overall In-App message elements as per your brand style guidelines to make them visually appealing.


Style Elements from Editor


Typeform and Character Limit

We do not currently support Typeform because its rendering requires access to local storage which is a security risk. CleverTap SDK WebView does not allow access to local storage.

The character limit for a message in English is 30 for the title and 128 for the message.
The character limit for a message in Chinese is 9 for the title and 38 for the message.