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

# Show an in-app popup

> Create an in-app popup template and choose who sees it and which event makes it appear.

## Overview

Before setting up a popup, integrate the [Android SDK](https://docs.notifly.tech/en/developer-guide/android-sdk.md) or [iOS SDK](https://docs.notifly.tech/en/developer-guide/ios-sdk.md) into your app.

The app loads popup campaigns when it starts. If you create or update a campaign while the app is open, it loads the changes the next time it starts.

## 1. Set the audience

Choose the user groups that should see the popup. See [Set up a user group](https://docs.notifly.tech/en/user-guide/campaigns/campaign-segments/segment.md#1-user-group-settings).

## 2. Set when to show the popup

To set the trigger, choose **Event-Based Send** and select the event that should show the popup.

### Example: Show a popup when a user adds an item to their cart

To show the popup immediately when the `add_to_cart` event occurs, use the settings below. You can also set a start and end date.

![Settings that show an in-app popup immediately after an add-to-cart event](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/in-app-message/in-app-message-timing.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=c64536a2eb2ca1c0ba7f9c9bdbdbed7d)

## 3. Set the message

In the sidebar, open **Message Templates > In-App Popup Templates**. Choose a design from the gallery. Customize it in the editor, then save it to use in a campaign.

![Template editor for an in-app popup](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/in-app-message/in-app-message-template-creation-2.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=b958d5c7738a0622468892bdcce706ee)

### Add an image

Check the recommended aspect ratio for your template when you upload an image.

![Aspect ratio guidance in the in-app popup editor](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/in-app-message/in-app-message-template-image-upload.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=436b827b6de18ceae22dcfa2501e2456)

### Customize the text and buttons

Edit the popup text and button labels. Use the color and style settings to match the popup to your app.

![Text and button color settings for an in-app popup](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/in-app-message/in-app-message-template-color-selection.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=efcb369a855548ce458ed1f4fa116fec)

### Set how long to hide the popup

In the legacy editor, add a **Do Not Show Again Button** so users can hide the popup. Set how long the popup stays hidden after a user taps the button.

![In-app popup hide duration settings](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/in-app-message/in-app-message-template-no-show-config.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=0eb8e1a5b18edda00f17260b5279fb4d)

### Create a campaign with the template

When you create an in-app popup campaign, click **Select Template** and choose one of your saved templates. See [Create a campaign](https://docs.notifly.tech/en/user-guide/campaigns/basic.md) for the full procedure.

![In-app popup template selector in a campaign](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/in-app-message/in-app-message-template-selection.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=3e416a4bcdcf916cf2882e6c86b762e1)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.