For the complete documentation index, see llms.txt. This page is also available as Markdown.

Media Connector

Configure dynamic images, video, audio, fit behavior, fallbacks, and Platform-editable media

Use the Media Connector when an image, video, or audio layer should be replaced dynamically. Typical uses include profile pictures, product images, brand logos, campaign backgrounds, video clips, and audio replacements.

Studio connector list with image and logo media connectors alongside their mapped replacement sources

Supported Media

Media type
Common formats
Checks before publishing

Images

PNG, JPG

Confirm the image loads, has the right aspect ratio, and has a fallback.

Video

MP4

Confirm playback, duration behavior, crop or fit behavior, and fallback video.

Audio

MP3

Confirm timing, volume, duration behavior, and fallback audio.

Options

Option
What it controls
Notes

Media layer

The placeholder asset that will be replaced.

The original layer boundaries define the area where replacement media appears.

Data source

A media URL, asset reference, live-control value, edit value, or expression.

Use Dynamic Data for viewer-specific assets and Live Control for shared logos or campaign assets.

Edit media

A replacement asset set directly in Studio.

Use for fixed media that may be changed from Platform.

Default or fallback

The asset shown when runtime media is missing or invalid.

Always set a fallback for visible media layers.

Fit or crop behavior

Whether replacement media fits inside the placeholder or is cropped to fill it.

Test assets with different aspect ratios.

Position

The placement of the replacement media inside the placeholder.

Confirm top, center, bottom, left, or right alignment as needed.

Duration handling

How video or audio length relates to the scene or original asset.

Use duration matching when the replacement should control timing.

Platform editing

Whether operators can replace the media from Platform Edit Content.

Enable for campaign assets, logos, or images that business users own.

Internal description

A note explaining what the media connector controls.

Use when a scene has several dynamic images or sounds.

Configure Dynamic Media

1

Select the Placeholder Layer

Choose the image, video, or audio layer that should be replaced at runtime.

2

Choose the Source

Select the Dynamic Data field, Live Control value, edit asset, or expression that should provide the replacement media.

3

Set Fit and Position

Choose how the replacement should sit inside the original layer boundaries. Preview square, portrait, and landscape assets when the source can vary.

4

Add a Fallback Asset

Set a safe fallback so the scene still looks complete when the media URL is empty, blocked, or invalid.

5

Validate Loading and Timing

Preview the scene with representative media. For video and audio, also check that the timing still matches the intended experience.

Success Checks

Before publishing a Media Connector, confirm:

  • The source field returns a reachable media URL or valid asset reference.

  • The media format is supported by the project and target channel.

  • Replacement assets fit the placeholder without awkward cropping.

  • Audio and video duration behavior matches the scene.

  • A fallback asset appears when the source is missing.

  • Platform editing is enabled only for media that operators should control.

Data in Studio

Last updated