> For the complete documentation index, see [llms.txt](https://help.blings.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.blings.io/apps/blings-studio/connectors/media-connector.md).

# Media Connector

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.

<figure><img src="/files/aYjJxUZwdCExQXDcxw63" alt="Studio connector list with image and logo media connectors alongside their mapped replacement sources" width="375"><figcaption></figcaption></figure>

## 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

{% stepper %}
{% step %}

### Select the Placeholder Layer

Choose the image, video, or audio layer that should be replaced at runtime.
{% endstep %}

{% step %}

### Choose the Source

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

{% step %}

### 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.
{% endstep %}

{% step %}

### Add a Fallback Asset

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

{% step %}

### Validate Loading and Timing

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

## 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.

{% content-ref url="/pages/vF3GOo8viXK19zuT75hD" %}
[Data in Studio](/apps/blings-studio/data.md)
{% endcontent-ref %}