mutation">productCreateMedia mutation
- Required access
On this page
Interactive example
Arguments
CreateMediaInput fields
Return fields
Deprecated return fields

productCreateMedia mutation

Creates media for a product.

Required access

write_products access scope.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.

mutation productCreateMedia($productId: ID!, $media: [CreateMediaInput!]!) { productCreateMedia(productId: $productId, media: $media) {

<font style="color:#1F61A0;">media</font> <font style="color:#555555;">{</font>
  <font style="color:#1F61A0;">alt</font>
<font style="color:#555555;">}</font>
<font style="color:#1F61A0;">mediaUserErrors</font> <font style="color:#555555;">{</font>
  <font style="color:#1F61A0;">code</font>
  <font style="color:#1F61A0;">field</font>
  <font style="color:#1F61A0;">message</font>
<font style="color:#555555;">}</font>
<font style="color:#1F61A0;">product</font> <font style="color:#555555;">{</font>
  <font style="color:#1F61A0;">id</font>
<font style="color:#555555;">}</font>

} } { “productId”: “Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=”, “media”: [

<font style="color:#555555;">{</font>
  <font style="color:#8B2BB9;">"originalSource"</font><font style="color:#555555;">:</font> <font style="color:#D64292;">"placeholder"</font><font style="color:#555555;">,</font>
  <font style="color:#8B2BB9;">"mediaContentType"</font><font style="color:#555555;">:</font> <font style="color:#D64292;">"placeholder"</font>
<font style="color:#555555;">}</font>

] }

Arguments

Argument	Description
`media` ( `[[CreateMediaInput!]!](https://shopify.dev/docs/admin-api/graphql/reference/products-and-collections/createmediainput)` ) REQUIRED	List of new media to be added to a product.
`productId` ( `[ID!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#id-2021-01)` ) REQUIRED	Specifies the product associated to the media.

CreateMediaInput fields

alt ([String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
The alt text associated to the media.
mediaContentType ([MediaContentType!](https://shopify.dev/docs/admin-api/graphql/reference/products-and-collections/mediacontenttype)) REQUIRED
The media content type.
originalSource ([String!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)) REQUIRED
The original source of the media object. May be an external URL or signed upload URL.

Return fields

media ([[Media!]](https://shopify.dev/docs/admin-api/graphql/reference/products-and-collections/media))
The newly created media.
mediaUserErrors ([[MediaUserError!]!](https://shopify.dev/docs/admin-api/graphql/reference/products-and-collections/mediausererror))
List of errors that occurred executing the mutation.
product ([Product](https://shopify.dev/docs/admin-api/graphql/reference/products-and-collections/product))
The product associated with the media.

Deprecated return fields

Show/Hide

userErrors ([[UserError!]!](https://shopify.dev/docs/admin-api/graphql/reference/usererror)) DEPRECATED
List of errors that occurred executing the mutation.
Deprecation warning
Use mediaUserErrors instead

productCreateMedia