--- title: Image - Storefront API description: >- An image resource with URL, dimensions, and transformation options. Used for product images, collection images, media previews, and other visual content throughout the storefront. The [`url`](/docs/api/storefront/2026-10/objects/Image#field-Image.fields.url) field accepts an [`ImageTransformInput`](/docs/api/storefront/2026-10/input-objects/ImageTransformInput) argument for resizing, cropping, scaling for retina displays, and converting between image formats. Use the [`thumbhash`](/docs/api/storefront/2026-10/objects/Image#field-Image.fields.thumbhash) field to display lightweight placeholders while images load. api_version: 2026-10 source_url: html: 'https://shopify.dev/docs/api/storefront/latest/objects/Image' md: 'https://shopify.dev/docs/api/storefront/latest/objects/Image.md' api_name: storefront api_type: graphql type: object --- # Image object An image resource with URL, dimensions, and transformation options. Used for product images, collection images, media previews, and other visual content throughout the storefront. The [`url`](https://shopify.dev/docs/api/storefront/2026-10/objects/Image#field-Image.fields.url) field accepts an [`ImageTransformInput`](https://shopify.dev/docs/api/storefront/2026-10/input-objects/ImageTransformInput) argument for resizing, cropping, scaling for retina displays, and converting between image formats. Use the [`thumbhash`](https://shopify.dev/docs/api/storefront/2026-10/objects/Image#field-Image.fields.thumbhash) field to display lightweight placeholders while images load. ## Fields * alt​Text [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) A word or phrase to share the nature or contents of an image. * height [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int) The original height of the image in pixels. Returns `null` if the image isn't hosted by Shopify. * id [ID](https://shopify.dev/docs/api/storefront/latest/scalars/ID) A unique ID for the image. * thumbhash [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The ThumbHash of the image. Useful to display placeholder images while the original image is loading. See for details on how to use it. * url [URL!](https://shopify.dev/docs/api/storefront/latest/scalars/URL) non-null The location of the image as a URL. If no transform options are specified, then the original image will be preserved including any pre-applied transforms. All transformation options are considered "best-effort". Any transformation that the original image type doesn't support will be ignored. If you need multiple variations of the same image, then you can use [GraphQL aliases](https://graphql.org/learn/queries/#aliases). * transform [Image​Transform​Input](https://shopify.dev/docs/api/storefront/latest/input-objects/ImageTransformInput) ### Arguments A set of options to transform the original image. *** * width [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int) The original width of the image in pixels. Returns `null` if the image isn't hosted by Shopify. ### Deprecated fields * original​Src [URL!](https://shopify.dev/docs/api/storefront/latest/scalars/URL) non-nullDeprecated * src [URL!](https://shopify.dev/docs/api/storefront/latest/scalars/URL) non-nullDeprecated * transformed​Src [URL!](https://shopify.dev/docs/api/storefront/latest/scalars/URL) non-nullDeprecated * crop [Crop​Region](https://shopify.dev/docs/api/storefront/latest/enums/CropRegion) ### Arguments Crops the image according to the specified region. * max​Height [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int) Image height in pixels between 1 and 5760. * max​Width [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int) Image width in pixels between 1 and 5760. * preferred​Content​Type [Image​Content​Type](https://shopify.dev/docs/api/storefront/latest/enums/ImageContentType) Best effort conversion of image into content type (SVG -> PNG, Anything -> JPG, Anything -> WEBP are supported). * scale [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int) Default:1 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. *** *** ## Map ### Fields and connections with this object * [Article.image](https://shopify.dev/docs/api/storefront/latest/objects/Article#field-Article.fields.image) * [Collection.image](https://shopify.dev/docs/api/storefront/latest/objects/Collection#field-Collection.fields.image) * [ExternalVideo.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/ExternalVideo#field-ExternalVideo.fields.previewImage) * [GenericFile.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/GenericFile#field-GenericFile.fields.previewImage) * [ImageConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/ImageConnection#returns-nodes) * [ImageEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/ImageEdge#field-ImageEdge.fields.node) * [Media.previewImage](https://shopify.dev/docs/api/storefront/latest/interfaces/Media#fields-previewImage) * [MediaImage.image](https://shopify.dev/docs/api/storefront/latest/objects/MediaImage#field-MediaImage.fields.image) * [MediaImage.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/MediaImage#field-MediaImage.fields.previewImage) * [Model3d.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/Model3d#field-Model3d.fields.previewImage) * [Product.featuredImage](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-Product.fields.featuredImage) * [Product.images](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-Product.fields.images) * [ProductVariant.image](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant#field-ProductVariant.fields.image) * [Video.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/Video#field-Video.fields.previewImage)