---
title: media - Shop Partners API
description: Retrieve active shop videos for a given entity
api_version: unstable latest
source_url:
  html: https://shopify.dev/docs/api/shop-partners/latest/queries/media
  md: https://shopify.dev/docs/api/shop-partners/latest/queries/media.md
---

# media

query

Retrieve active shop videos for a given entity

## Arguments

* entity​Id

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

  required

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

***

## Possible returns

* Shop​Video

  [\[Shop​Video!\]!](https://shopify.dev/docs/api/shop-partners/latest/objects/ShopVideo)

  Represents a shop video with related products.

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

***

## Examples

* ### media reference