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

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 → SettingsCustom dataProductsAdd 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.

Last updated