Media
Represents an error that happens during execution of a Media query or mutation.
Anchor to FieldsFields
- Anchor to codecode•Media
User Error Code The error code.
- Anchor to fieldfield•[String!]
The path to the input field that caused the error.
- Anchor to messagemessage•String!non-null
The error message.
Anchor to MutationsMutations
- •mutation
Asynchronously reorders the media attached to a product, changing the sequence in which images, videos, and other media appear in product displays. This affects how media is presented across all sales channels.
For example, merchants can move their best product photo to the first position or reorder images to tell a better product story, with changes appearing in storefronts once processing completes.
Use
to:- Optimize media presentation order for better customer experience
- Implement drag-and-drop media management interfaces
- Automate media sequencing based on performance or quality metrics
The operation processes asynchronously to handle products with large media collections without blocking other operations.
Learn more about product media.
- •mutation
Appends existing media from a product to specific variants of that product, creating associations between media files and particular product options. This allows different variants to showcase relevant images or videos.
For example, a t-shirt product might have color variants where each color variant displays only the images showing that specific color, helping customers see exactly what they're purchasing.
Use
to:- Associate specific images with product variants for accurate display
- Build variant-specific media management in product interfaces
- Implement automated media assignment based on variant attributes
The operation links existing product media to variants without duplicating files, maintaining efficient media storage while enabling variant-specific displays.
Learn more about product variants.
- •mutation
Detaches media from product variants.
Deprecated mutations
- •mutationDeprecated
- •mutationDeprecated
- •mutationDeprecated