---
title: Image - Storefront API
description: Represents an image resource.
api_version: 2025-10
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/image
  md: https://shopify.dev/docs/api/storefront/latest/objects/image.md
---

# Image

object

Represents an image resource.

## 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 <https://evanw.github.io/thumbhash/> 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

  * max​Width

    [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

    ### Arguments

    Image width in pixels between 1 and 5760.

  * max​Height

    [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

    Image height in pixels between 1 and 5760.

  * crop

    [Crop​Region](https://shopify.dev/docs/api/storefront/latest/enums/CropRegion)

    Crops the image according to the specified region.

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

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

  ***

***

## Map

### Fields and connections with this object

* {}[Article.image](https://shopify.dev/docs/api/storefront/latest/objects/Article#field-image)
* {}[Collection.image](https://shopify.dev/docs/api/storefront/latest/objects/Collection#field-image)
* {}[ExternalVideo.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/ExternalVideo#field-previewImage)
* {}[GenericFile.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/GenericFile#field-previewImage)
* <->[ImageConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/ImageConnection#field-nodes)
* {}[ImageEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/ImageEdge#field-node)
* ||-[Media.previewImage](https://shopify.dev/docs/api/storefront/latest/interfaces/Media#field-previewImage)
* {}[MediaImage.image](https://shopify.dev/docs/api/storefront/latest/objects/MediaImage#field-image)
* {}[MediaImage.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/MediaImage#field-previewImage)
* {}[Model3d.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/Model3d#field-previewImage)
* {}[Product.featuredImage](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-featuredImage)
* {}[Product.images](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-images)
* {}[ProductVariant.image](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant#field-image)
* {}[Video.previewImage](https://shopify.dev/docs/api/storefront/latest/objects/Video#field-previewImage)