What is Modal Rich Media and how do I use it?

Modal Rich Media is a display mode in which In-App / Rich Media content is shown in a modal window positioned on part of the screen (top, center, bottom or bottom sheet) instead of covering it completely. The modal is non-blocking — users can still interact with the rest of your app — and it can be dismissed with a swipe.

Uploading an HTML archive is not enough: modal presentation must be switched on in the app, otherwise Rich Media falls back to the legacy full-screen display.

Android (Pushwoosh Android SDK 6.7.13+) — add this meta-data inside the <application> tag of AndroidManifest.xml:

<meta-data
    android:name="com.pushwoosh.rich_media_type"
    android:value="Modal" />

Appearance (position, present/dismiss animations, swipe gesture, window width, status-bar handling) is configured with RichMediaManager.setDefaultRichMediaConfig(new ModalRichmediaConfig()...).

iOS (Pushwoosh iOS SDK 6.7.5+) — either add the key to Info.plist:

<key>Pushwoosh_RICH_MEDIA_STYLE</key>
<string>MODAL_RICH_MEDIA</string>

…or configure it programmatically (SDK 7.0.14+):

Pushwoosh.media.setRichMediaPresentationStyle(.modal)
Pushwoosh.media.modalRichMedia.configure(
    position: .PWModalWindowPositionBottom,
    presentAnimation: .PWAnimationPresentFromBottom,
    dismissAnimation: .PWAnimationDismissDown
)

Full reference: Android modal rich media and iOS modal rich media.