Logo
Docs

In-App Messages

Use in-app messages for time-sensitive promotions, launches, and onboarding prompts that should appear inside the app at a specific moment. Messages can be full screen or half screen, include one or two buttons, and target a defined audience.

Overview

In-app messages work best when the campaign has a clear action:

  • announce a new release
  • promote a livestream or limited-time offer
  • move viewers to a membership or one-time purchase page
  • onboard new users into a part of the product they have not seen yet

Every in-app message requires an audience. If no audience is selected, the campaign will not deliver.

Campaign Workflow

The current workflow has two parts:

  1. Create the campaign and verify the content, trigger, audience, and schedule.
  2. Return to the campaign list to review, filter, or remove campaigns over time.

If you want the step-by-step creation flow, start with Creating Your First In-App Message.

Create A Campaign

When you click New In-App Message, the editor collects the fields that actually control delivery:

  • Campaign name for internal tracking
  • Title and description
  • Message size: full screen or half screen
  • Background image
  • Primary button and optional secondary button
  • Trigger
  • Audience
  • Start time and optional end time

Content Guidelines

  • Keep titles short enough to scan quickly on a phone.
  • Use the description to explain the value, not to repeat the title.
  • Use a background image that supports the message instead of competing with it.
  • Keep the call to action specific. "Watch the trailer" works better than "Learn more."

Image Requirements

  • JPG, PNG, or WebP
  • under 2 MB
  • 1200 x 800 is a reliable working size

Buttons

Each campaign can include:

  • one required primary button
  • one optional secondary button

Buttons can link to:

  • app routes
  • content detail pages
  • purchase flows
  • external websites
  • store links

Manage Existing Campaigns

The campaign list is the part many teams miss. It is where you keep the system usable after the first launch.

From the main In-App Messaging view you can:

  • search by title
  • filter by message type
  • filter by trigger type
  • review all matching campaigns in one table
  • select multiple campaigns and bulk delete them

Use the list view before major launches to retire outdated campaigns. Old promos left active in the system make targeting harder to reason about.

Targeting And Triggers

Trigger Types

The current trigger options are:

  • Everywhere for broad campaigns
  • App Launched for immediate post-open messaging
  • Navigating to Page for contextual prompts tied to a destination
  • Finished Watching for follow-up prompts after playback

Choose the least intrusive trigger that still matches the goal. A completion prompt after a video usually performs better than interrupting the viewer before playback.

Audience Rules

Audience selection is required. You can narrow campaigns by platform and audience definitions so the same message does not have to be shown to everyone.

If you are running a sensitive launch, build a small internal audience first and verify delivery there before expanding to the broader target group.

Scheduling And Testing

Scheduling

Use start and end times to keep campaigns bounded. This matters for launches, flash sales, and seasonal messaging.

  • Set the start time in the timezone that matches your campaign plan.
  • Add an end time if the message should expire automatically.
  • Use short windows while testing so stale test campaigns do not remain active.

Before You Publish

Run through this checklist:

  • confirm the audience is selected
  • confirm the trigger matches the intended user action
  • test every button URL
  • verify the preview on the right side of the editor
  • use a small internal audience before sending the campaign to everyone

Ongoing Maintenance

After launch, keep the list clean:

  • remove campaigns that are no longer valid
  • update links if the destination changed
  • search for older campaigns with similar names before recreating them
  • use trigger and message-type filters when preparing the next campaign

Troubleshooting

Message is not showing

Check these first:

  • the campaign has an audience
  • the start time has already passed
  • the end time has not expired
  • the trigger condition actually occurred
  • the target platform matches the device you are testing on

Image upload fails

Make sure the file is JPG, PNG, or WebP and keep it under the size limit. If the design still feels heavy after upload, replace it with a simpler image rather than forcing more text on top of it.

Button sends users to the wrong place

Open every link yourself before you publish. Most campaign issues come from wrong destinations, not the message renderer.

Filters do not match what you expect

The list view applies title search separately from the structured filters. If the table looks wrong, clear the title search, re-apply your message type and trigger filters, and check again.

Need the creation walkthrough?

Use the dedicated walkthrough here:

Next steps:

  1. Set up your audience segments
  2. Create your first message

Was this page helpful?