---
title: MediaImage - GraphQL Admin
description: >-
  The `MediaImage` object represents an image hosted on Shopify's

  [content delivery network
  (CDN)](https://shopify.dev/docs/storefronts/themes/best-practices/performance/platform#shopify-cdn).

  Shopify CDN is a content system that serves as the primary way to store,

  manage, and deliver visual content for products, variants, and other resources
  across the Shopify platform.


  The `MediaImage` object provides information to:


  - Store and display product and variant images across online stores, admin
  interfaces, and mobile apps.

  - Retrieve visual branding elements, including logos, banners, favicons, and
  background images in checkout flows.

  - Retrieve signed URLs for secure, time-limited access to original image
  files.


  Each `MediaImage` object provides both the processed image data (with
  automatic optimization and CDN delivery)

  and access to the original source file. The image processing is handled
  asynchronously, so images

  might not be immediately available after upload. The

  [`status`](https://shopify.dev/docs/api/admin-graphql/latest/objects/mediaimage#field-MediaImage.fields.status)

  field indicates when processing is complete and the image is ready for use.


  The `MediaImage` object implements the
  [`Media`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Media)

  interface alongside other media types, like videos and 3D models.


  Learn about

  managing media for
  [products](https://shopify.dev/docs/apps/build/online-store/product-media),

  [product
  variants](https://shopify.dev/docs/apps/build/online-store/product-variant-media),
  and

  [asynchronous media
  management](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components#asynchronous-media-management).
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/MediaImage'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/MediaImage.md'
---

# Media​Image

object

Requires `read_products` access scope, `read_files` access scope, `read_themes` access scope, `read_orders` access scope, `read_draft_orders` access scope, `read_images` access scope or `read_quick_sale` access scope.

The `MediaImage` object represents an image hosted on Shopify's [content delivery network (CDN)](https://shopify.dev/docs/storefronts/themes/best-practices/performance/platform#shopify-cdn). Shopify CDN is a content system that serves as the primary way to store, manage, and deliver visual content for products, variants, and other resources across the Shopify platform.

The `MediaImage` object provides information to:

* Store and display product and variant images across online stores, admin interfaces, and mobile apps.
* Retrieve visual branding elements, including logos, banners, favicons, and background images in checkout flows.
* Retrieve signed URLs for secure, time-limited access to original image files.

Each `MediaImage` object provides both the processed image data (with automatic optimization and CDN delivery) and access to the original source file. The image processing is handled asynchronously, so images might not be immediately available after upload. The [`status`](https://shopify.dev/docs/api/admin-graphql/latest/objects/mediaimage#field-MediaImage.fields.status) field indicates when processing is complete and the image is ready for use.

The `MediaImage` object implements the [`Media`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Media) interface alongside other media types, like videos and 3D models.

Learn about managing media for [products](https://shopify.dev/docs/apps/build/online-store/product-media), [product variants](https://shopify.dev/docs/apps/build/online-store/product-variant-media), and [asynchronous media management](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components#asynchronous-media-management).

## Fields

* alt
* createdAt
* fileErrors
* fileStatus
* id
* image
* mediaContentType
* mediaErrors
* mediaWarnings
* mimeType
* originalSource
* preview
* status
* translations
* updatedAt

### Deprecated fields

* metafield: deprecated
* metafields: deprecated

***

## Map

### Fields with this object

* [ProductOptionValueSwatch.image](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductOptionValueSwatch#field-ProductOptionValueSwatch.fields.image)

### Possible type in

* [Metafield​Reference](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReference)

***

## Interfaces

* File
* HasMetafields
* HasPublishedTranslations
* Media
* Node

***

## MediaImage Implements

### Implements

* [File](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/File)
* [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)
* [Media](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Media)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)