Image

Represents an image, including its metadata, file information, and variant associations.

Type Definition


type Image {
  alt: String
  url: String
  title: String
  description: String
  tags: [String]
  aiProcessed: Boolean
  width: Int
  height: Int
  aspectRatio: String
  mimeType: String
  fileExtension: String
  fileSize: Int
  fileName: String
  orientation: String
  sortOrder: Int
  type: String
  attachedToVariant: Boolean
  variants: [ProductVariant]
}

Fields

Field	Type	Description
alt	String	The alt text for the image, used for accessibility and SEO.
url	String	The direct URL to the image file.
title	String	The title of the image, often used as alt text.
description	String	The description of the image, if available.
tags	[String]	The tags associated with the image.
aiProcessed	Boolean	Indicates whether the image has been processed by AI.
width	Int	The width of the image in pixels.
height	Int	The height of the image in pixels.
aspectRatio	String	The aspect ratio of the image, such as 16:9.
mimeType	String	The MIME type of the image file.
fileExtension	String	The file extension of the image, such as jpg or png.
fileSize	Int	The size of the image file in bytes.
fileName	String	The file name of the image.
orientation	String	The orientation of the image, such as landscape or portrait.
sortOrder	Int	The sort order of the image among other images.
type	String	The type of media, which is always ‘image’ for this drop.
attachedToVariant	Boolean	Indicates whether the image is attached to a product variant. Only available when accessed through product image or media methods.
variants	[ProductVariant]	The product variants this image is attached to. Only available when accessed through product image or media methods.

Relationships

The Image type is used to represent visual assets across multiple areas of the product catalog. It is referenced by ProductBundleContent as an image asset, by ProductOptionValue to visualize option selections, by Product as the featured image, and by ProductVariant for both standard and featured variant images. The variants field establishes a relationship to the ProductVariant type, indicating which variants the image is associated with.

Example


{
  alt
  url
  title
  description
  tags
  aiProcessed
  width
  height
  aspectRatio
  mimeType
  fileExtension
  fileSize
  fileName
  orientation
  sortOrder
  type
  attachedToVariant
  variants {
    id
  }
}

Implements

None

ProductVariant