The Flow Builder includes three media element types under the Media category: Image, Video, and Icon.

Image

Upload a .JPG, .PNG, or .GIF file up to 20 MB.

• Aspect — controls how the image fits its container:
  • Fit — scales the image to fit inside the container without cropping.
  • Fill — stretches the image to fill the container.
  • Cover — scales the image to cover the container, cropping if needed. Default.
• Use custom media ID — see Custom media ID below.

Video

Upload an .MP4 or .WEBM file up to 50 MB.

• Aspect — Fit, Fill, or Cover. Defaults to Fill.
• Loop — replay the video continuously. On by default.
• Use custom media ID — see Custom media ID below.

Videos do not play in the editor preview — the canvas shows a still frame. On the device at runtime, the video plays muted by default. With Loop on, it repeats indefinitely.

Trigger an action when the video ends

The Video element supports an On playback finished trigger that fires when the video reaches the end. Set it up in the Interactions panel to navigate to another screen, reveal a CTA, or run any other action.

Icon

Pick from the bundled Tabler Icons library, with thousands of icons in two visual styles:

• Stroke — outline only.
• Filled — solid fill.

Search the picker by keyword to find an icon. Set the icon’s color in the Color picker — pick a saved color style or set a custom color.

Custom media ID

Tag an image or video element with a custom media ID to swap it at runtime from your app code. Use this for personalized visuals — for example, showing the user’s selected avatar.

The media you upload in the Flow Builder serves as the fallback. If your code doesn’t provide media for the ID at runtime, the fallback renders instead.

To enable a custom media ID on an Image or Video element:

1. Select the Use custom media ID checkbox under the upload area.
2. Enter a media ID.
3. Upload a fallback image or video.

In your app code, fetch media by its ID — see Customize assets for the SDK API.