In-app message integration
In-app messages help you get content to your user without interrupting their day with a push notification. Customized and tailored in-app messages enhance the user experience and help your audience get the most value from your app. With a variety of layouts and customization tools to choose from, in-app messages engage your users more than ever before.
Check out our case studies to see examples of in-app messages.
In-app message types
Braze currently offers the following default in-app message types:
- Modal Image
- Full Image
- Custom HTML
Each in-app message type is highly customizable across content, images, icons, click actions, analytics, display, and delivery.
For a full list of in-app message properties and usage, refer to the
InAppMessage class documentation.
All in-app messages are enumerated types of
Braze.InAppMessage, which defines basic behavior and traits for all in-app messages. Each type of in-app message and its corresponding details is listed in the tabs below.
Expected behaviors by message types
This is what it looks like for your users to open one of our default in-app message types.
Slideup in-app messages are so-named because they “slide up” or “slide down” from the top or bottom of the screen. They cover a small portion of the screen and provide an effective and non-intrusive messaging capability.
Modal in-app messages appear in the center of the screen and are framed by a translucent panel. Useful for more critical messaging, they can be equipped with up to two analytics-enabled buttons.
Modal Image in-app messages appear in the center of the screen and are framed by a translucent panel. These messages are similar to the
Modal type except without header or message text. Useful for more critical messaging, they can be equipped with up to two analytics-enabled buttons.
Full in-app messages are useful for maximizing the content and impact of your user communication. The upper half of a
Full in-app message contains an image, and the lower half displays text and up to two analytics-enabled buttons.
Full Image in-app messages are similar to
Full in-app messages except without header or message text. This message type is useful for maximizing the content and impact of your user communication. A
Full Image in-app message contains an image spanning the entire screen, with the option to display up to two analytics-enabled buttons.
HTML in-app messages are useful for creating fully customized user content. User-defined HTML Full in-app message content is displayed in a
WKWebViewand may optionally contain other rich content, such as images and fonts, allowing for full control over message appearance and functionality.
brazeBridge interface to call methods on the Braze Web SDK from within your HTML, see our best practices for more details.
The following example shows a paginated HTML Full in-app message:
Note that we currently do not support the display of custom HTML in-app messages in an iFrame on the iOS and Android platforms.
Control in-app messages do not contain a UI component and are used primarily for analytics purposes. This type is used to verify receipt of an in-app message sent to a control group.
For further details about Intelligent Selection and control groups, refer to Intelligent Selection.
The standard SDK integration includes steps that activate in-app messages, including GIF support. For more details on GIF support, refer to this tutorial.