Send a rich interstitial message (beta)

The rich interstitial message is a more flexible version of our standard interstitial in-app message. In addition to the interstitial background and hero images, rich interstitials can support up to two buttons (each with their own open action), as well as a close button in the top right corner.

Rich interstitials are perfect for asking users to accept, decline or ignore (close) a message, like accepting updated terms and conditions.

Requires the following versions of our SDK:

  • iOS: 2.0.0+
  • Android: 2.2.0+

Compose the message. Enter the message title under Title > Text value, then enter the message text in Message > Text value. It’s best to keep the length to a minimum, but you can increase the height of the message to accommodate longer messages.

Choose a trigger. The rich interstitial is an in-app message, so it must be triggered by some user action. Under Display when, select the trigger from the list of options.

Add button actions. Button actions determine what happens when the user selects a button. Under Select button 1 action and Select button 2 action, choose either Open URL, Register For Push, or Chain to a new message.

Change the style

Change the message dimensions. You can set the height and width of the message in absolute px or %. We recommend testing your message on a variety of devices in portrait and landscape to make sure it will render well for all of your users.

Add a hero image. You can add a hero image above the title and message. Click Hero Image > Image to open the Image picker, then select the image. You may need to adjust the message height to make room for the image.

Be sure the aspect ratio of your image is equal to the aspect ratio set in the Composer (width:height). The default aspect ratio is 340:140. For best results, leave the hero width set to 100% and use the message width to make adjustments. Remember, changing the message width will change the hero image's aspect ratio. Widening to 400px, for example, would change the required ratio to 400:140.

Note: If your image has a different ratio, it will be scaled and letterboxed (see background-size: contain in the MDN docs).


Add a background image. You can add a background image behind the message text and buttons. Click View > Background image to open the Image picker, then select the image.

Be sure the aspect ratio of the image is equal to that of the message itself (width:height). Otherwise, the background image will be letterboxed to fill in any gaps (see background-size: contain in the MDN docs).

Tip: If you set a background image, you might need to change the color and opacity of the submit button to make sure it is legible. The button is transparent by default, which can make it difficult to read on certain image backgrounds.


Add a video. You can add video (Youtube, vimeo, etc.) by placing the embeddable code in Message > Text value. To ensure the video is aligned and sized properly, remove the height style attribute from the embedded HTML code and set the width to the width of the message itself (defaults to 340px).

For the best results, you may need to adjust the message height and/or hide the buttons by setting Show button to “false”.

Tip: To nudge the video up or down inside the message template, add another <div> with a margin setting.
<div style="position:relative;height:0;padding-bottom:56.25%">
  <iframe src="" width="640" height="360" frameborder="0" style="position:absolute;width:100%;height:100%;left:0" allowfullscreen>
<div style="margin-bottom:-20px;"></div>


Was this article helpful?
Have more questions? Submit a request