> For the complete documentation index, see [llms.txt](https://docs.webexp.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.webexp.dev/drift-shopify-theme/drift-studio/metafields/feed-bg-media.md).

# Feed background media

A per-product file metafield (image or video) that takes over the active slide's background on the DRIFT Product Feed. Highest priority — overrides both the solid color morph and the Live Gradient on the slide where it's set.

## Namespace and key

`custom.feed_bg_media` — type **File**.

## How to set it up

1. Shopify admin → **Settings** → **Custom data** → **Products** → **Add definition**
2. Name: `Feed background media`
3. Namespace and key: `custom.feed_bg_media`
4. Type: **File** → accept **All files** (so merchants can upload either image or video)
5. One value (not list)
6. Storefronts → Read access on
7. Save

## How to use it

On any product, scroll to Metafields → Feed background media → upload an image or video. Save.

* **Video** — autoplays muted and loops on the active slide
* **Image** — static background

## Performance notes

Video backgrounds add page weight. For meta-ad creatives or specific drops where you want max visual impact, this is fine. For a 50-product catalog with a video per product, page weight scales fast.

Recommended specs:

* Under 2 MB per video
* 10 seconds or shorter
* 720p MP4 with H.264 codec
* Compressed (use HandBrake or FFmpeg)

## Background media blur

The Product Feed section has a **Background media blur** slider (0–30px) that applies to image and video backgrounds. Useful when the media is busy and you want the product to stand out — a small blur keeps the vibe without competing for attention. Doesn't affect solid color or gradient backgrounds.

## Priority chain

When multiple metafields are set on the same product:

1. `feed_bg_media` (this) — wins, takes over completely
2. `feed_bg_color` (gradient seed or solid color)
3. Site-wide theme gradient or theme background

## Enable the feature

Per-product backgrounds require **Enable per-product background overrides** turned on in the DRIFT Product Feed section settings.