---
title: ShopVideo - Shop Partners API
description: Represents a shop video with related products.
api_version: unstable latest
source_url:
  html: https://shopify.dev/docs/api/shop-partners/latest/objects/ShopVideo
  md: https://shopify.dev/docs/api/shop-partners/latest/objects/ShopVideo.md
---

# Shop​Video

object

Represents a shop video with related products.

## Fields

* id

  [ID!](https://shopify.dev/docs/api/shop-partners/latest/scalars/ID)

  non-null

  A globally-unique identifier for the video.

* media​Image​Id

  [ID](https://shopify.dev/docs/api/shop-partners/latest/scalars/ID)

  The Shopify Media Image ID in GID format.

* preview​Image​Url

  [URL!](https://shopify.dev/docs/api/shop-partners/latest/scalars/URL)

  non-null

  The URL of the preview image for the video.

* related​Products

  [\[Related​Product!\]!](https://shopify.dev/docs/api/shop-partners/latest/objects/RelatedProduct)

  non-null

  List of products and variants related to this video.

* status

  [Shop​Video​Status!](https://shopify.dev/docs/api/shop-partners/latest/enums/ShopVideoStatus)

  non-null

  The status of the video (active or inactive).

* video​Id

  [ID](https://shopify.dev/docs/api/shop-partners/latest/scalars/ID)

  The Shopify Video ID in GID format.

* video​Url

  [URL!](https://shopify.dev/docs/api/shop-partners/latest/scalars/URL)

  non-null

  The URL of the video.

***

## Map

No referencing types

***

## Queries

* [media](https://shopify.dev/docs/api/shop-partners/latest/queries/media)

  query

  Retrieve active shop videos for a given entity

  * entity​Id

    [ID!](https://shopify.dev/docs/api/shop-partners/latest/scalars/ID)

    required

    ### Arguments

    The Product or ProductVariant ID in GID format (e.g., gid://shopify/Product/123 or gid://shopify/ProductVariant/456)

  ***

***

## ShopVideo Queries

### Queried by

* [media](https://shopify.dev/docs/api/shop-partners/latest/queries/media)

***

## Mutations

* [media​Create](https://shopify.dev/docs/api/shop-partners/latest/mutations/mediaCreate)

  mutation

  Create a new shop video with related products.

  * input

    [Media​Create​Input!](https://shopify.dev/docs/api/shop-partners/latest/input-objects/MediaCreateInput)

    required

    ### Arguments

  ***

* [media​Update](https://shopify.dev/docs/api/shop-partners/latest/mutations/mediaUpdate)

  mutation

  Update an existing shop video.

  * input

    [Media​Update​Input!](https://shopify.dev/docs/api/shop-partners/latest/input-objects/MediaUpdateInput)

    required

    ### Arguments

  ***

***

## ShopVideo Mutations

### Mutated by

* [media​Create](https://shopify.dev/docs/api/shop-partners/latest/mutations/mediaCreate)
* [media​Update](https://shopify.dev/docs/api/shop-partners/latest/mutations/mediaUpdate)