Przejdź do głównej zawartości

Image

An image with its URL and presentation metadata. The URL accepts an Image.url(transform: ...) argument for responsive resizing / format selection.

type Image {
  altText: String
  height: Int
  id: ID
  thumbhash: String
  url(
    transform: ImageTransformInput
  ): String!
  width: Int
}

Fields​

Image.altText ● String scalar​

Alt text for accessibility / SEO. Null when the merchant has not provided one.

Image.height ● Int scalar​

Native height of the source image in pixels.

Image.id ● ID scalar​

Stable image identifier. Null for ad-hoc images that are not stored as media library entries.

Image.thumbhash ● String scalar​

ThumbHash placeholder for progressive loading (base64-encoded, ~40 chars). Decode with thumbHashToDataURL() on the client to render an instant blurry preview while the full image loads.

Image.url ● String! non-null scalar​

Public image URL. Pass an optional transform argument (max width / height, crop region, scale, preferred format) to obtain a resized / reformatted CDN variant — useful for responsive images and modern formats like WebP / AVIF.

Image.url.transform ● ImageTransformInput input​

Optional CDN transform (maxWidth/maxHeight/crop/scale/preferredContentType WEBP/AVIF)

Image.width ● Int scalar​

Native width of the source image in pixels.

Member Of​

AttributeSwatch object ● BlogAuthor object ● BlogCategory object ● BlogPost object ● Brand object ● BrandFilterValue object ● Category object ● Collection object ● ImageConnection object ● ImageEdge object ● LoyaltyReward object ● MenuItem object ● PaymentInstrument object ● PaymentMethod object ● Product object ● ProductReview object ● ProductVariant object ● ReturnItem object ● ShipmentItem object ● ShippingCarrier object ● Shop object ● ShopBrand object ● ShopBranding object ● TierBenefit object