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

# Image

object

Represents an image resource.

## Fields

* alt​Text

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A word or phrase to share the nature or contents of an image.

* height

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

  [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  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/customer/latest/scalars/ID)

  [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A unique ID for the image.

* thumbhash

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The ThumbHash of the image.

  Useful to display placeholder images while the original image is loading.

* url

  [URL!](https://shopify.dev/docs/api/customer/latest/scalars/URL)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  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/customer/latest/input-objects/ImageTransformInput)

    ### Arguments

    A set of options to transform the original image.

  ***

* width

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

  [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  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/customer/latest/scalars/URL)

  non-nullDeprecated[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

* src

  [URL!](https://shopify.dev/docs/api/customer/latest/scalars/URL)

  non-nullDeprecated[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

* transformed​Src

  [URL!](https://shopify.dev/docs/api/customer/latest/scalars/URL)

  non-nullDeprecated[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  * max​Width

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

    ### Arguments

    Image width in pixels between 1 and 5760.

  * max​Height

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

    Image height in pixels between 1 and 5760.

  * crop

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

    Crops the image according to the specified region.

  * scale

    [Int](https://shopify.dev/docs/api/customer/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/customer/latest/enums/ImageContentType)

    Best effort conversion of image into content type (SVG -> PNG, Anything -> JPG, Anything -> WEBP are supported).

  ***

***

## Map

### Fields with this object

* {}[DraftOrderLineItem.image](https://shopify.dev/docs/api/customer/latest/objects/DraftOrderLineItem#field-image)
* {}[ExchangeLineItem.image](https://shopify.dev/docs/api/customer/latest/objects/ExchangeLineItem#field-image)
* {}[LineItem.image](https://shopify.dev/docs/api/customer/latest/objects/LineItem#field-image)
* {}[LineItemGroup.image](https://shopify.dev/docs/api/customer/latest/objects/LineItemGroup#field-image)
* {}[SubscriptionLine.image](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionLine#field-image)
* {}[SubscriptionLine.variantImage](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionLine#field-variantImage)