Skip to main content

Overview

Build an in-app popup by arranging blocks in Notifly’s visual editor.

Minimum SDK versions

To display these popups, use the Notifly SDK version listed for your platform, or a later version.
  • Android - 1.17.0
  • iOS - 1.17.0
  • Flutter - 1.11.0
  • React Native - 3.9.0
Personalized text requires Notifly SDK 1.24.0 or later for Android, 2.8.0 or later for iOS, 2.6.0 or later for Flutter on both platforms, or 4.5.0 or later for React Native. Older SDKs do not display popups that contain personalization. The standard minimum versions above apply to popups without personalization.

Create a template

In the sidebar, go to Message Templates > In-App Popup Templates.
In-app popup template list
If you’re using the legacy editor, click Use latest editor. Then click Create New Template.
Template creation dialog
Choose a layout, or select Start from scratch to build the template from a blank canvas.

Editor layout

Editor with the toolbar, block panel, canvas, and settings panel
The top toolbar has a template name field and controls to undo, redo, preview, and save. Use the left panel to add a block. Image, Text, Button, Divider, Spacer, and HTML add content. Row lays out columns. Carousel and Indicator work with slides. The canvas shows the popup as you edit. Use the device and resolution menus at the top to see how it looks at different screen sizes, including mobile, tablet, and desktop. The right panel shows the style settings for the selected block. When you clear the selection, the panel shows settings for the entire popup.

Add a block

Select a block in the left panel to add it to the canvas. Click it on the canvas to show its blue outline and toolbar.
Toolbar for a selected block
  • Use Move up or Move down to reorder the block.
  • Use Duplicate block to make a copy with the same settings.
  • Use Delete block to remove it.
Block selected on the canvas

Content blocks

Add an Image block, then upload the image in the right panel. Set the width as a percentage. For height, choose automatic sizing or set an aspect ratio. You can also set the corner radius, margin, click action, and alternative text. Image URLs and click actions in Image blocks don’t accept personalization variables. Enter the text for a Text block in the right panel. Set the font, size, line height, weight, color, and alignment for the block. To format part of the text, select it and use the bold, italic, underline, or color controls. To insert a user’s name or event data, add a personalization variable.
  1. Select the Text block and place the cursor in Text content where you want to insert the variable.
  2. Click Personalization Variable below the field.
  3. Set the Variable Type and Variable Name. Under Default Value (Optional), enter what to show when the variable has no value.
  4. Click Paste to insert the Liquid expression at the cursor.
Personalization settings showing the name property and its default value in Korean
For example, choose User as the variable type and enter name as the variable name. Enter there as the default value to show “Hi there!” if the user’s name is missing. The screenshot uses the Korean fallback 고객 (customer).
Text block with a personalization variable. The canvas shows the Liquid expression before substitution.
You can also enter Liquid directly. See Message personalization basics for supported data and syntax. Add a Button block and set its label, background color and opacity, corner radius, border, font style, text color, alignment, and padding. The default click action is Close. Choose Open link to open a URL or deep link. To personalize the button text, choose Personalization Variable in Content > Label. To personalize a URL or deep link, choose Open link under Click action and use Personalization Variable in the Link field. Use a Divider block to add a line between sections. Use a Spacer block to add space between blocks. Use an HTML block for content that needs custom HTML and CSS. From an HTML element’s event handler, you can call notiflyPopup methods to close the popup, open a link, or control a carousel. Click Personalization Variable in the HTML field to insert a variable. Enter Liquid directly to write conditions or loops, read from a catalog, or use Connected Content or abort_message. When abort_message runs, the popup doesn’t appear.

Call notiflyPopup methods

Call methods from the onclick attribute of an HTML element, as shown below.

Identify which button a user clicked

In the Button block settings, enter a name in the field marked button_name. Notifly includes the name in the click event. Give each button a different name if you want to track clicks separately.

Layout blocks

A Row block puts two to four columns side by side. Set the width of each column as a proportion of the row, then set vertical alignment and block spacing. You can also set the background color, opacity, and outer margin. Add blocks such as Image, Text, or Button to each column. Add a Carousel to display slides. Each popup can contain one carousel. Select the carousel to open its settings in the right panel.
  • Slide management. Add a slide or select an existing one to reorder, duplicate, or delete it.
  • Slide transition. Choose an animation (Slide, Fade, or None) and decide whether to allow swiping or looping.
  • Autoplay. Turn on automatic slide transitions and set the time between slides.
  • Indicator. Choose dots or a slide number. Set the position, offsets, size, and spacing. For dots, set the colors of the active and inactive dots. For a slide number, set the text and background colors.
Add an Indicator block to place the carousel indicator elsewhere in the popup. Click an empty part of the canvas or click Popup at the top of the right panel to edit the settings for the entire popup.
  • Dialog appears in the center of the screen. This is the default.
  • Bottom Sheet slides up from the bottom of the screen.
  • Full Screen fills the screen.

Background

Set the background color, opacity, or image of the popup content area. Set the padding and block spacing. If the popup type supports it, set the maximum width and corner radius in pixels. Switch to individual inputs to set a different radius for each corner or different padding for each side.

Overlay

For a dialog or bottom sheet, set the overlay color and opacity. Turn on Close on click to close the popup when the user clicks the overlay.

Animation

Set Enter animation and Exit animation separately. For each, choose None, Fade, Slide Up, Slide Down, Slide Left, or Slide Right.

Close button

Choose whether to show the close (X) button. Set the corner (top left or top right), placement (inside or outside the popup), size in pixels, stroke weight, icon color, and horizontal and vertical offsets.

Save and use the template

Click Save in the toolbar. To use a template from In-app Popup Templates, select it when you set up a campaign or user journey. When you save a template containing personalization variables, Notifly enables personalization automatically. When the popup appears, Notifly fills in the variables with user or event data.
Preview shows the Liquid expression before Notifly fills in the actual values. To test what users will see, run a campaign for test users only. Trigger the configured event in an app that uses a supported SDK version.

FAQ

Blocks and their content stay in place. Some style settings may reset, depending on the new type. Choose a type before editing the individual styles.
At the bottom of the font list, click Add font. In Google Fonts, select a font and click Get font, then Get embed code. Copy the URL that starts with https://fonts.googleapis.com/ and paste it into Webfont URL. In Font name, enter the exact name shown in Google Fonts. Click Load font, then Add.