--- title: Image - GraphQL Admin description: Represents an image resource. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/objects/Image md: https://shopify.dev/docs/api/admin-graphql/latest/objects/Image.md --- # Image object Represents an image resource. ## Fields * alt​Text [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) A word or phrase to share the nature or contents of an image. * height [Int](https://shopify.dev/docs/api/admin-graphql/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/admin-graphql/latest/scalars/ID) A unique ID for the image. * metafield [Metafield](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield) A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. * metafields [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MetafieldConnection) non-null A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. * thumbhash [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The ThumbHash of the image. Useful to display placeholder images while the original image is loading. * translations [\[Translation!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/Translation) non-null The published translations associated with the resource. * url [URL!](https://shopify.dev/docs/api/admin-graphql/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/admin-graphql/latest/input-objects/ImageTransformInput) ### Arguments A set of options to transform the original image. *** * width [Int](https://shopify.dev/docs/api/admin-graphql/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/admin-graphql/latest/scalars/URL) non-nullDeprecated * src [URL!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL) non-nullDeprecated * transformed​Src [URL!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL) non-nullDeprecated * max​Width [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int) ### Arguments Image width in pixels between 1 and 5760. * max​Height [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int) Image height in pixels between 1 and 5760. * crop [Crop​Region](https://shopify.dev/docs/api/admin-graphql/latest/enums/CropRegion) Crops the image according to the specified region. * scale [Int](https://shopify.dev/docs/api/admin-graphql/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/admin-graphql/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 * {}[AbandonedCheckoutLineItem.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/AbandonedCheckoutLineItem#field-AbandonedCheckoutLineItem.fields.image) * {}[AbandonedCheckoutLineItemComponent.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/AbandonedCheckoutLineItemComponent#field-AbandonedCheckoutLineItemComponent.fields.image) * {}[App.banner](https://shopify.dev/docs/api/admin-graphql/latest/objects/App#field-App.fields.banner) * {}[App.icon](https://shopify.dev/docs/api/admin-graphql/latest/objects/App#field-App.fields.icon) * {}[App.screenshots](https://shopify.dev/docs/api/admin-graphql/latest/objects/App#field-App.fields.screenshots) * {}[Article.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/Article#field-Article.fields.image) * {}[CalculatedDraftOrderLineItem.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/CalculatedDraftOrderLineItem#field-CalculatedDraftOrderLineItem.fields.image) * {}[CalculatedLineItem.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/CalculatedLineItem#field-CalculatedLineItem.fields.image) * {}[CheckoutBrandingHeaderCartLink.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingHeaderCartLink#field-CheckoutBrandingHeaderCartLink.fields.image) * {}[CheckoutBrandingImage.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingImage#field-CheckoutBrandingImage.fields.image) * {}[CheckoutBrandingLogo.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingLogo#field-CheckoutBrandingLogo.fields.image) * {}[Collection.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection#field-Collection.fields.image) * {}[CommentEventAttachment.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/CommentEventAttachment#field-CommentEventAttachment.fields.image) * {}[Customer.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-Customer.fields.image) * {}[DeliveryCarrierService.icon](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryCarrierService#field-DeliveryCarrierService.fields.icon) * {}[DiscountShareableUrl.targetItemImage](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountShareableUrl#field-DiscountShareableUrl.fields.targetItemImage) * {}[DraftOrderLineItem.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.image) * {}[FulfillmentOrderLineItem.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrderLineItem#field-FulfillmentOrderLineItem.fields.image) * <->[ImageConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/ImageConnection#returns-nodes) * {}[ImageEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/ImageEdge#field-ImageEdge.fields.node) * {}[LineItem.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem#field-LineItem.fields.image) * {}[MediaImage.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/MediaImage#field-MediaImage.fields.image) * {}[MediaPreviewImage.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/MediaPreviewImage#field-MediaPreviewImage.fields.image) * {}[OrderApp.icon](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderApp#field-OrderApp.fields.icon) * {}[OrderTransaction.paymentIcon](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction#field-OrderTransaction.fields.paymentIcon) * {}[PriceRuleShareableUrl.targetItemImage](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceRuleShareableUrl#field-PriceRuleShareableUrl.fields.targetItemImage) * {}[SearchResult.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/SearchResult#field-SearchResult.fields.image) * {}[StaffMember.avatar](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember#field-StaffMember.fields.avatar) * {}[SubscriptionLine.variantImage](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionLine#field-SubscriptionLine.fields.variantImage) *** ## Interfaces * * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) interface * [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations) interface *** ## ||-Image Implements ### Implements * ||-[Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) * ||-[Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations)