Choose a version:

Media

interface

Requires unauthenticated_read_product_listings access scope.

A common set of fields for media content associated with products. Implementations include MediaImage for Shopify-hosted images, Video for Shopify-hosted videos, ExternalVideo for videos hosted on platforms like YouTube or Vimeo, and Model3d for 3D models.

Each implementation shares fields for alt text, content type, and preview images, while adding type-specific fields like embed URLs for external videos or source files for 3D models.

Anchor to FieldsFields

Anchor to altalt

•String

A word or phrase to share the nature or contents of a media.

Anchor to idid

•ID!

non-null

A globally-unique ID.

Anchor to mediaContentTypemediaContentType

•MediaContentType!

non-null

The media content type.

Anchor to presentationpresentation

•MediaPresentation

The presentation for a media.

Anchor to previewImagepreviewImage

•Image

The preview image for the media.

Was this section helpful?

Anchor to Types implemented inTypes implemented in

Anchor to ExternalVideo ExternalVideo •OBJECT: Represents a video hosted outside of Shopify.
Anchor to MediaImage MediaImage •OBJECT: An image hosted on Shopify's content delivery network (CDN). Used for product images, brand logos, and other visual content across the storefront.

The image field provides the actual image data with transformation options. Implements the Media interface alongside other media types like Video and Model3d.
Anchor to Model3d Model3d •OBJECT: Represents a Shopify hosted 3D model.
Anchor to Video Video •OBJECT: A video hosted on Shopify's servers. Implements the Media interface and provides multiple video sources through the sources field, each with format, dimensions, and URL information for adaptive playback.

For videos hosted on external platforms like YouTube or Vimeo, use ExternalVideo instead.

Was this section helpful?

{

"alt": "",

"id": "",

"mediaContentType": "",

"presentation": "",

"previewImage": ""

}

Variables

{
	"alt": "",
	"id": "",
	"mediaContentType": "",
	"presentation": "",
	"previewImage": ""
}

Schema

interface Media {
  alt: String
  id: ID!
  mediaContentType: MediaContentType!
  presentation: MediaPresentation
  previewImage: Image
}