> For the complete documentation index, see [llms.txt](https://modutheme.gitbook.io/helix/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modutheme.gitbook.io/helix/how-to-guides/how-to-set-up-video-reviews.md). # How to set up video reviews The **Video reviews** block shows a row of customer review videos on the product page. Tapping one opens a vertical reel in a popup (a bottom sheet on mobile) with the current product pinned as an add-to-cart card. Each product reads its own videos from a metafield, so every product can show a different set. You can use uploaded video files, or links to videos hosted on YouTube or Vimeo. {% embed url="" %} Video walkthrough: add video reviews to product pages with Helix. {% endembed %} *** ## Step 1 — Create the metafield In Shopify admin, go to **Settings → Metafields and metaobjects → Products** and click **Add definition**, then set: * **Name** — `Video reviews` * **Namespace and key** — `modutheme.video_reviews` * **Type** — Video (File), list of values Click **Save**. ![Creating the video\_reviews metafield definition in Shopify admin](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-f700540c8d9e5a7db0122a26019d59f43e75ea4a%2Fhow-to-video-reviews-metafield.png?alt=media) {% hint style="warning" %} The namespace and key must be exactly `modutheme.video_reviews`. Helix reads this fixed key — any other name is ignored. {% endhint %} *** ## Step 2 — Upload review videos to a product 1. Open a product in Shopify admin. 2. Scroll to **Metafields → Video reviews**. 3. Add one or more video files (upload new ones or pick from **Content → Files**). 4. Save the product. Repeat for every product that should show review videos. Videos appear in the order you add them. ![Adding review videos to a product's Video reviews metafield](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-087b5e139112fb65a4ea2c3ae64ec79d5c18277e%2Fhow-to-video-reviews-upload.png?alt=media) *** ## Step 3 — Add the block to the product page In the theme editor, open a product template → **Product information** section → **Details** block → **Add block → Video reviews**, then save. ![Adding the Video reviews block to the product Details block](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-f2415ee7e97cdc0a59d1ea7a6ed7792c97302528%2Fhow-to-video-reviews-add-block.png?alt=media) {% hint style="info" %} Uploaded videos must be Shopify-hosted MP4 files. To use YouTube or Vimeo links instead, see [Play YouTube and Vimeo links](#play-youtube-and-vimeo-links) below. A product with no review videos and no review links shows no feed — the block stays hidden for that product. {% endhint %} *** ## Play YouTube and Vimeo links Instead of uploading files, you can point a product to videos hosted on YouTube or Vimeo. Each link is stored as a **Video review** entry holding the video link and a cover image, and a product metafield lists those entries. ### Step 1 — Create the Video review entry type {% hint style="success" %} 1. In Shopify admin, go to **Settings → Metafields and metaobjects → Metaobjects** and click **Add definition**. 2. Set the **Name** to `Video review`, and make sure its type is `video_review`. 3. Add a field named `Video URL` with the key `video_url` and the type **URL**. 4. Add a field named `Cover image` with the key `cover_image` and the type **File → Image**. 5. Click **Save**. {% endhint %} {% hint style="warning" %} The type and the two field keys must be exactly `video_review`, `video_url` and `cover_image`. Helix reads these fixed names — any other name is ignored. {% endhint %} ### Step 2 — Create the links metafield {% hint style="success" %} 1. Go to **Settings → Metafields and metaobjects → Products** and click **Add definition**. 2. Set the **Name** to `Video review links`. 3. Set the **Namespace and key** to `modutheme.video_review_links`. 4. Set the **Type** to **Metaobject → Video review**, as a list of values. 5. Click **Save**. {% endhint %} ### Step 3 — Add entries to a product {% hint style="success" %} 1. Open a product in Shopify admin and scroll to **Metafields → Video review links**. 2. Add a new **Video review** entry with the video link and a cover image. 3. Repeat for each video, then save the product. {% endhint %} Links appear in the order you add them. Helix recognises these link formats: | Provider | Supported links | | -------- | ------------------------------------------------------------------------------------ | | YouTube | `youtube.com/watch?v=…`, `youtu.be/…`, `youtube.com/embed/…`, `youtube.com/shorts/…` | | Vimeo | `vimeo.com/` followed by the numeric video ID, for example `vimeo.com/123456789` | A link in any other format is skipped. **How links behave** * **In the feed** — each card shows its cover image. With **Preview mode** set to **Autoplay preview** or **Autoplay sequence**, a muted preview plays on top of the cover. See [Video reviews](/helix/features/video-reviews.md#feed-preview-settings) for the options. * **In the popup** — the video plays in the same popup reel as uploaded videos, with the sound button and progress bar. The cover image shows until the video starts. {% hint style="info" %} **When both exist:** if a product has uploaded videos in **Video reviews**, only those are shown and **Video review links** is ignored. Links are used only when the product has no uploaded videos. The two lists are never mixed. {% endhint %} *** ## Alternative: the standalone Video reviews section To show the same reel on a page that isn't tied to a single product, add the **Video reviews** section instead and upload videos directly into its child blocks in the theme editor — no metafield required. This section plays uploaded videos only, not YouTube or Vimeo links. *** {% hint style="info" icon="headset" %} **Need help?** Whether you have a question, run into an issue, or just need some guidance, our support team is here to help. Chat with us Submit a ticket {% endhint %}