Product
Requires access scope.
The Product object lets you manage products in a merchant’s store.
Products are the goods and services that merchants offer to customers. They can include various details such as title, description, price, images, and options such as size or color. You can use product variants to create or update different versions of the same product. You can also add or update product media. Products can be organized by grouping them into a collection.
Learn more about working with Shopify's product model, including limitations and considerations.
Anchor to Fields and connectionsFields and connections
- Anchor to availablePublicationsCountavailable•
Publications Count The number of publications that a resource is published to, without feedback errors.
- Anchor to bundleComponentsbundle•
Components A list of components that are associated with a product in a bundle.
- Anchor to categorycategory•
The category of a product from Shopify's Standard Product Taxonomy.
- Anchor to collectionscollections•Collection
Connection!non-null A list of collections that include the product.
- Anchor to combinedListingcombined•
Listing A special product type that combines separate products from a store into a single product listing. Combined listings are connected by a shared option, such as color, model, or dimension.
- Anchor to combinedListingRolecombined•
Listing Role The role of the product in a combined listing.
If
null, then the product isn't part of any combined listing.- Anchor to compareAtPriceRangecompare•
At Price Range The compare-at price range of the product in the shop's default currency.
- Anchor to contextualPricingcontextual•
Pricing ProductContextual Pricing!non-null The pricing that applies to a customer in a specific context. For example, a price might vary depending on the customer's location. As of API version 2025-04, only active markets are considered in the price resolution.
- Anchor to createdAtcreated•
At DateTime!non-null The date and time when the product was created.
- Anchor to defaultCursordefault•
Cursor String!non-null A default cursor that returns the single next record, sorted ascending by ID.
- Anchor to descriptiondescription•String!non-null
A single-line description of the product, with HTML tags removed.
- Anchor to descriptionHtmldescription•
Html HTML!non-null The description of the product, with HTML tags. For example, the description might include bold
<strong></strong>and italic<i></i>text.- Anchor to eventsevents•Event
Connection!non-null The paginated list of events associated with the host subject.
- Anchor to featuredMediafeatured•
Media The featured media associated with the product.
- Anchor to feedbackfeedback•
The information that lets merchants know what steps they need to take to make sure that the app is set up correctly.
For example, if a merchant hasn't set up a product correctly in the app, then the feedback might include a message that says "You need to add a price to this product".
- Anchor to giftCardTemplateSuffixgift•
Card Template Suffix The theme template that's used when customers view the gift card in a store.
- Anchor to handlehandle•String!non-null
A unique, human-readable string of the product's title. A handle can contain letters, hyphens (
-), and numbers, but no spaces. The handle is used in the online store URL for the product.- Anchor to hasOnlyDefaultVarianthas•
Only Default Variant Boolean!non-null Whether the product has only a single variant with the default option and value.
- Anchor to hasOutOfStockVariantshas•
Out Of Stock Variants Boolean!non-null Whether the product has variants that are out of stock.
- Anchor to hasVariantsThatRequiresComponentshas•
Variants That Requires Components Boolean!non-null Whether at least one of the product variants requires bundle components.
Learn more about store eligibility for bundles.
- •ID!non-null
A globally-unique ID.
- Anchor to inCollectionin•
Collection Boolean!non-null Whether the product is in a specified collection.
- Anchor to isGiftCardis•
Gift Card Boolean!non-null Whether the product is a gift card.
- Anchor to legacyResourceIdlegacy•
Resource Id UnsignedInt64!non-null The ID of the corresponding resource in the REST Admin API.
- Anchor to mediamedia•Media
Connection!non-null The media associated with the product. Valid media are images, 3D models, videos.
- Anchor to mediaCountmedia•
Count The total count of media that's associated with a product.
- Anchor to metafieldmetafield•
A custom field, including its
namespaceandkey, that's associated with a Shopify resource for the purposes of adding and storing additional information.- Anchor to metafieldsmetafields•Metafield
Connection!non-null A list of custom fields that a merchant associates with a Shopify resource.
- Anchor to onlineStorePreviewUrlonline•
Store Preview Url The preview URL for the online store.
- Anchor to onlineStoreUrlonline•
Store Url The product's URL on the online store. If
null, then the product isn't published to the online store sales channel.- Anchor to optionsoptions•[Product
Option!]!non-null A list of product options. The limit is defined by the shop's resource limits for product options (
).- Anchor to priceRangeV2price•
Range V2 ProductPrice Range V2!non-null The minimum and maximum prices of a product, expressed in decimal numbers. For example, if the product is priced between $10.00 and $50.00, then the price range is $10.00 - $50.00.
- Anchor to productTypeproduct•
Type String!non-null The product type that merchants define.
- Anchor to publishedAtpublished•
At The date and time when the product was published to the online store.
- Anchor to publishedInContextpublished•
In Context Boolean!non-null Whether the product is published for a customer only in a specified context. For example, a product might be published for a customer only in a specific location.
- Anchor to publishedOnCurrentPublicationpublished•
On Current Publication Boolean!non-null Whether the resource is published to the app's publication. For example, the resource might be published to the app's online store channel.
- Anchor to publishedOnPublicationpublished•
On Publication Boolean!non-null Whether the resource is published to a specified publication.
- Anchor to requiresSellingPlanrequires•
Selling Plan Boolean!non-null Whether the product can only be purchased with a selling plan. Products that are sold on subscription (
) can be updated only for online stores. If you update a product to be subscription-only (), then the product is unpublished from all channels, except the online store.- Anchor to resourcePublicationOnCurrentPublicationresource•
Publication On Current Publication The resource that's either published or staged to be published to the publication.
- Anchor to resourcePublicationsresource•
Publications ResourcePublication Connection!non-null The list of resources that are published to a publication.
- Anchor to resourcePublicationsCountresource•
Publications Count The number of publications that a resource is published to, without feedback errors.
- Anchor to resourcePublicationsV2resource•
Publications V2 ResourcePublication V2Connection!non-null The list of resources that are either published or staged to be published to a publication.
- Anchor to restrictedForResourcerestricted•
For Resource Whether the merchant can make changes to the product when they edit the order associated with the product. For example, a merchant might be restricted from changing product details when they edit an order.
- Anchor to sellingPlanGroupsselling•
Plan Groups SellingPlan Group Connection!non-null A list of all selling plan groups that are associated with the product either directly, or through the product's variants.
- Anchor to sellingPlanGroupsCountselling•
Plan Groups Count A count of selling plan groups that are associated with the product.
- •SEO!non-null
The SEO title and description that are associated with a product.
- Anchor to statusstatus•Product
Status!non-null The product status, which controls visibility across all sales channels.
- •[String!]!non-null
A comma-separated list of searchable keywords that are associated with the product. For example, a merchant might apply the
sportsandsummertags to products that are associated with sportwear for summer.Updating
tagsoverwrites any existing tags that were previously added to the product. To add new tags without overwriting existing tags, use themutation.- Anchor to templateSuffixtemplate•
Suffix The theme template that's used when customers view the product in a store.
- Anchor to titletitle•String!non-null
The name for the product that displays to customers. The title is used to construct the product's handle. For example, if a product is titled "Black Sunglasses", then the handle is
black-sunglasses.- Anchor to totalInventorytotal•
Inventory Int!non-null The quantity of inventory that's in stock.
- Anchor to tracksInventorytracks•
Inventory Boolean!non-null Whether inventory tracking has been enabled for the product.
- Anchor to translationstranslations•[Translation!]!non-null
The published translations associated with the resource.
- Anchor to unpublishedPublicationsunpublished•
Publications PublicationConnection!non-null The list of publications that the resource isn't published to.
- Anchor to updatedAtupdated•
At DateTime!non-null The date and time when the product was last modified. A product's
value can change for different reasons. For example, if an order is placed for a product that has inventory tracking set up, then the inventory adjustment is counted as an update.- Anchor to variantsvariants•Product
Variant Connection!non-null A list of variants associated with the product. If querying a single product at the root, you can fetch up to 2000 variants.
- Anchor to variantsCountvariants•
Count The number of variants that are associated with the product.
- Anchor to vendorvendor•String!non-null
The name of the product's vendor.
Deprecated fields and connections
- Anchor to bodyHtmlbody•
Html The description of the product, with HTML tags. For example, the description might include bold
<strong></strong>and italic<i></i>text.- Anchor to customProductTypecustom•
Product Type The custom product type specified by the merchant.
- Anchor to descriptionPlainSummarydescription•
Plain Summary String!non-null Stripped description of the product, single line with HTML tags removed. Truncated to 60 characters.
- Anchor to featuredImagefeatured•
Image The featured image for the product.
- Anchor to imagesimages•Image
Connection!non-null The images associated with the product.
- Anchor to metafieldDefinitionsmetafield•
Definitions MetafieldDefinition Connection!non-null List of metafield definitions.
- Anchor to priceRangeprice•
Range ProductPrice Range!non-null The price range of the product.
- Anchor to productCategoryproduct•
Category The product category specified by the merchant.
- Anchor to productPublicationsproduct•
Publications ProductPublication Connection!non-null A list of the channels where the product is published.
- Anchor to publicationCountpublication•
Count Int!non-null The number of publications that a resource is published to, without feedback errors.
- Anchor to publicationspublications•Product
Publication Connection!non-null A list of the channels where the product is published.
- Anchor to publishedOnChannelpublished•
On Channel Boolean!non-null Whether the resource is published to a specific channel.
- Anchor to publishedOnCurrentChannelpublished•
On Current Channel Boolean!non-null Whether the resource is published to a channel. For example, the resource might be published to the online store channel.
- Anchor to sellingPlanGroupCountselling•
Plan Group Count Int!non-null A count of selling plan groups that are associated with the product.
- Anchor to standardizedProductTypestandardized•
Product Type The standardized product type in the Shopify product taxonomy.
- Anchor to storefrontIdstorefront•
Id StorefrontID!non-null The Storefront GraphQL API ID of the
Product.As of the
2022-04version release, the Storefront GraphQL API will no longer return Base64 encoded IDs to match the behavior of the Admin GraphQL API. Therefore, you can safely use theidfield's value instead.- Anchor to totalVariantstotal•
Variants Int!non-null The number of variants that are associated with the product.
- Anchor to unpublishedChannelsunpublished•
Channels ChannelConnection!non-null The list of channels that the resource is not published to.
Anchor to QueriesQueries
- •query
Returns a Product resource by ID.
- •query
Return a product by an identifier.
- •query
Returns a list of products.
- •query
Return a product by its handle.
Anchor to MutationsMutations
- •mutation
Add, remove and update
s of a given Product.s are comprised of multiple products to create a single listing. There are two kinds of products used in a:- Parent products
- Child products
The parent product is created with a
with aof. Once created, you can associate child products with the parent product using this mutation. Parent products represent the idea of a product (e.g. Shoe).Child products represent a particular option value (or combination of option values) of a parent product. For instance, with your Shoe parent product, you may have several child products representing specific colors of the shoe (e.g. Shoe - Blue). You could also have child products representing more than a single option (e.g. Shoe - Blue/Canvas, Shoe - Blue/Leather, etc...).
The combined listing is the association of parent product to one or more child products.
Learn more about Combined Listings.
- Anchor to optionsAndValuesoptions•
And Values The ordered options and values to be used by the combined listing. Options and values will be reordered to match the order specified here.
- Anchor to parentProductIdparent•
Product Id ID!required The ID of the parent product.
- Anchor to productsAddedproducts•
Added The child products to add and their assigned options and option values.
- Anchor to productsEditedproducts•
Edited The child products to edit and their assigned options and option values.
- Anchor to productsRemovedIdsproducts•
Removed Ids The IDs of products to be removed from the combined listing.
- Anchor to titletitle•
The updated title for the combined listing.
Arguments
- Anchor to productproduct•
The parent product.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates the fixed prices for all variants for a product on a price list. You can use the
mutation to set or remove a fixed price for all variants of a product associated with the price list.- Anchor to priceListIdprice•
List Id ID!required The price list to update the prices for.
- Anchor to pricesToAddprices•
To Add A list of
that identifies which products to update the fixed prices for.- Anchor to pricesToDeleteByProductIdsprices•
To Delete By Product Ids A list of product IDs that identifies which products to remove the fixed prices for.
Arguments
- Anchor to priceListprice•
List The price list for which the fixed prices were modified.
- Anchor to pricesToAddProductsprices•
To Add Products The product for which the fixed prices were added.
- Anchor to pricesToDeleteProductsprices•
To Delete Products The product for which the fixed prices were deleted.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •mutation
Creates a product with attributes such as title, description, and vendor. You can use the
mutation to define options and values for products with product variants, such as different sizes or colors.To create multiple product variants for a single product and manage prices, use the
mutation.To create or update a product in a single request, use the
mutation.Learn more about the product model and adding product data.
- Anchor to inputinput•
The properties of the new product.
- Anchor to mediamedia•
The media to add to the product.
- Anchor to productproduct•
The attributes of the new product.
Arguments
- Anchor to productproduct•
The product object.
- Anchor to shopshop•Shop!non-null
The shop associated with the product.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Duplicates a product.
If you need to duplicate a large product, such as one that has many variants that are active at several locations, you might encounter timeout errors.
To avoid these timeout errors, you can instead duplicate the product asynchronously.
In API version 2024-10 and higher, include
synchronous: falseargument in this mutation to perform the duplication asynchronously.In API version 2024-07 and lower, use the asynchronous
.Metafield values are not duplicated if the unique values capability is enabled.
- Anchor to includeImagesinclude•
Images BooleanDefault:false Specifies whether or not to duplicate images.
- Anchor to includeTranslationsinclude•
Translations BooleanDefault:false Specifies whether or not to duplicate translations.
- Anchor to newStatusnew•
Status The new status of the product. If no value is provided the status will be inherited from the original product.
- Anchor to newTitlenew•
Title String!required The new title of the product.
- Anchor to productIdproduct•
Id ID!required The ID of the product to be duplicated.
- Anchor to synchronoussynchronous•BooleanDefault:true
Specifies whether or not to run the mutation synchronously.
Arguments
- Anchor to imageJobimage•
Job The asynchronous job that duplicates the product images.
- Anchor to newProductnew•
Product The duplicated product.
- Anchor to productDuplicateOperationproduct•
Duplicate Operation The product duplicate operation, returned when run in asynchronous mode.
- Anchor to shopshop•Shop!non-null
The user's shop.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Adds multiple selling plan groups to a product.
- •ID!required
The ID of the product.
- Anchor to sellingPlanGroupIdsselling•
Plan Group Ids [ID!]!required The IDs of the selling plan groups to add.
Arguments
- Anchor to productproduct•
The product object.
- Anchor to userErrorsuser•
Errors [SellingPlan Group User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •
- •mutation
Removes multiple groups from a product.
- •ID!required
The ID of the product.
- Anchor to sellingPlanGroupIdsselling•
Plan Group Ids [ID!]!required The IDs of the selling plan groups to add.
Arguments
- Anchor to productproduct•
The product object.
- Anchor to userErrorsuser•
Errors [SellingPlan Group User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •
- •mutation
Creates options on a product.
- Anchor to optionsoptions•[Option
Create Input!]!required Options to add to the product.
- Anchor to productIdproduct•
Id ID!required The ID of the product to update.
- Anchor to variantStrategyvariant•
Strategy ProductOption Create Variant StrategyDefault:LEAVE_AS_IS The strategy defines which behavior the mutation should observe regarding variants. If not provided or set to null, the strategy
will be used.
Arguments
- Anchor to productproduct•
The updated product object.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •mutation
Deletes the specified options.
- Anchor to optionsoptions•[ID!]!required
IDs of the options to delete from the product.
- Anchor to productIdproduct•
Id ID!required ID of the product from which to delete the options.
- Anchor to strategystrategy•Product
Option Delete StrategyDefault:DEFAULT The strategy defines which behavior the mutation should observe,such as how to handle a situation where deleting an option would result in duplicate variants.
Arguments
- Anchor to deletedOptionsIdsdeleted•
Options Ids IDs of the options deleted.
- Anchor to productproduct•
The updated product object.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •mutation
Reorders options and option values on a product, causing product variants to alter their position.
Options order take precedence over option values order. Depending on the existing product variants, some input orders might not be achieved.
Example: Existing product variants: ["Red / Small", "Green / Medium", "Blue / Small"].
New order: [ { name: "Size", values: [{ name: "Small" }, { name: "Medium" }], name: "Color", values: [{ name: "Green" }, { name: "Red" }, { name: "Blue" }] } ].
Description: Variants with "Green" value are expected to appear before variants with "Red" and "Blue" values. However, "Size" option appears before "Color".
Therefore, output will be: ["Small / "Red", "Small / Blue", "Medium / Green"].
- Anchor to optionsoptions•[Option
Reorder Input!]!required Options to reorder on the product.
- Anchor to productIdproduct•
Id ID!required The ID of the product to update.
Arguments
- Anchor to productproduct•
The updated product object.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates a product option.
- Anchor to optionoption•Option
Update Input!required Option to update.
- Anchor to optionValuesToAddoption•
Values To Add New option values to create.
- Anchor to optionValuesToDeleteoption•
Values To Delete IDs of the existing option values to delete.
- Anchor to optionValuesToUpdateoption•
Values To Update Existing option values to update.
- Anchor to productIdproduct•
Id ID!required The ID of the Product the Option belongs to.
- Anchor to variantStrategyvariant•
Strategy The strategy defines which behavior the mutation should observe regarding variants, such as creating variants or deleting them in response to option values to add or to delete. If not provided or set to null, the strategy
will be used.
Arguments
- Anchor to productproduct•
The product with which the option being updated is associated.
- Anchor to userErrorsuser•
Errors [ProductOption Update User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Creates or updates a product in a single request.
Use this mutation when syncing information from an external data source into Shopify.
When using this mutation to update a product, specify that product's
idin the input.Any list field (e.g. collections, metafields, variants) will be updated so that all included entries are either created or updated, and all existing entries not included will be deleted.
All other fields will be updated to the value passed. Omitted fields will not be updated.
When run in synchronous mode, you will get the product back in the response. For versions
2024-04and earlier, the synchronous mode has an input limit of 100 variants. This limit has been removed for versions2024-07and later.In asynchronous mode, you will instead get a ProductSetOperation object back. You can then use the productOperation query to retrieve the updated product data. This query uses the
object to check the status of the operation and to retrieve the details of the updated product and its variants.If you need to update a subset of variants, use one of the bulk variant mutations:
If you need to update options, use one of the product option mutations:
See our guide to sync product data from an external source for more.
- Anchor to inputinput•Product
Set Input!required The properties of the newly created or updated product.
- Anchor to synchronoussynchronous•BooleanDefault:true
Whether the mutation should be run synchronously or asynchronously.
If
true, the mutation will return the updatedproduct.If
false, the mutation will return a.Defaults to
true.Setting
synchronous: falsemay be desirable depending on the input complexity/size, and should be used if you are experiencing timeouts.Note: When run in the context of a bulk operation, the mutation will always run synchronously and this argument will be ignored.
Arguments
- Anchor to productproduct•
The product object.
- Anchor to productSetOperationproduct•
Set Operation The product set operation, returned when run in asynchronous mode.
- Anchor to userErrorsuser•
Errors [ProductSet User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates a product.
For versions
2024-01and older: If you update a product and only include some variants in the update, then any variants not included will be deleted.To safely manage variants without the risk of deleting excluded variants, use productVariantsBulkUpdate.
If you want to update a single variant, then use productVariantUpdate.
- Anchor to inputinput•
The updated properties for a product.
- Anchor to mediamedia•
List of new media to be added to the product.
- Anchor to productproduct•
The updated properties for a product.
Arguments
- Anchor to productproduct•
The updated product object.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Appends media from a product to variants of the product.
- Anchor to productIdproduct•
Id ID!required Specifies the product associated to the media.
- Anchor to variantMediavariant•
Media A list of pairs of variants and media to be attached to the variants.
Arguments
- Anchor to productproduct•
The product associated with the variants and media.
- Anchor to productVariantsproduct•
Variants The product variants that were updated.
- Anchor to userErrorsuser•
Errors [MediaUser Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Detaches media from product variants.
- Anchor to productIdproduct•
Id ID!required Specifies the product to which the variants and media are associated.
- Anchor to variantMediavariant•
Media A list of pairs of variants and media to be deleted from the variants.
Arguments
- Anchor to productproduct•
The product associated with the variants and media.
- Anchor to productVariantsproduct•
Variants The product variants that were updated.
- Anchor to userErrorsuser•
Errors [MediaUser Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Creates multiple variants in a single product. This mutation can be called directly or via the bulkOperation.
- Anchor to mediamedia•
List of new media to be added to the product.
- Anchor to productIdproduct•
Id ID!required The ID of the product on which to create the variants.
- Anchor to strategystrategy•Product
Variants Bulk Create StrategyDefault:DEFAULT The strategy defines which behavior the mutation should observe, such as whether to keep or delete the standalone variant (when product has only a single or default variant) when creating new variants in bulk.
- Anchor to variantsvariants•[Product
Variants Bulk Input!]!required An array of product variants to be created.
Arguments
- Anchor to productproduct•
The updated product object.
- Anchor to productVariantsproduct•
Variants The newly created variants.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •mutation
Deletes multiple variants in a single product. This mutation can be called directly or via the bulkOperation.
- Anchor to productIdproduct•
Id ID!required The ID of the product with the variants to update.
- Anchor to variantsIdsvariants•
Ids [ID!]!required An array of product variants IDs to delete.
Arguments
- Anchor to productproduct•
The updated product object.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •mutation
Reorders multiple variants in a single product. This mutation can be called directly or via the bulkOperation.
- Anchor to positionspositions•[Product
Variant Position Input!]!required An array of variant positions.
- Anchor to productIdproduct•
Id ID!required The product ID of the variants to be reordered.
Arguments
- Anchor to productproduct•
The updated product.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates multiple variants in a single product. This mutation can be called directly or via the bulkOperation.
- Anchor to allowPartialUpdatesallow•
Partial Updates BooleanDefault:false When partial updates are allowed, valid variant changes may be persisted even if some of the variants updated have invalid data and cannot be persisted. When partial updates are not allowed, any error will prevent all variants from updating.
- Anchor to mediamedia•
List of new media to be added to the product.
- Anchor to productIdproduct•
Id ID!required The ID of the product associated with the variants to update.
- Anchor to variantsvariants•[Product
Variants Bulk Input!]!required An array of product variants to update.
Arguments
- Anchor to productproduct•
The updated product object.
- Anchor to productVariantsproduct•
Variants The updated variants.
- Anchor to userErrorsuser•
Errors The list of errors that occurred from executing the mutation.
Fields
Deprecated mutations
- •mutation
Changes the status of a product. This allows you to set the availability of the product across all channels.
- Anchor to productIdproduct•
Id ID!required The ID of the product.
- Anchor to statusstatus•Product
Status!required The status to be assigned to the product.
Arguments
- Anchor to productproduct•
The product object.
- Anchor to userErrorsuser•
Errors [ProductChange Status User Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Creates media for a product.
- Anchor to mediamedia•[Create
Media Input!]!required List of new media to be added to a product.
- Anchor to productIdproduct•
Id ID!required Specifies the product associated with the media.
Arguments
- Anchor to mediamedia•
The newly created media.
- Anchor to mediaUserErrorsmedia•
User Errors [MediaUser Error!]!non-null The list of errors that occurred from executing the mutation.
- Anchor to productproduct•
The product associated with the media.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Deletes media for a product.
- Anchor to mediaIdsmedia•
Ids [ID!]!required The media IDs to be deleted.
- Anchor to productIdproduct•
Id ID!required Specifies the product ID from which the media will be deleted.
Arguments
- Anchor to deletedMediaIdsdeleted•
Media Ids List of media IDs which were deleted.
- Anchor to deletedProductImageIdsdeleted•
Product Image Ids List of product image IDs which were deleted.
- Anchor to mediaUserErrorsmedia•
User Errors [MediaUser Error!]!non-null The list of errors that occurred from executing the mutation.
- Anchor to productproduct•
The product associated with the deleted media.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Publishes a product. Products that are sold exclusively on subscription (
) can only be published on online stores.- Anchor to inputinput•Product
Publish Input!required Specifies the product to publish and the channels to publish it to.
Arguments
- Anchor to productproduct•
The product that has been published.
- Anchor to shopshop•Shop!non-null
The user's shop.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
- Anchor to productPublicationsproduct•
Publications The channels where the product is published.
Fields
- •mutation
Unpublishes a product.
- Anchor to inputinput•Product
Unpublish Input!required Specifies the product to unpublish and the channel to unpublish it from.
Arguments
- Anchor to productproduct•
The product that has been unpublished.
- Anchor to shopshop•Shop!non-null
The user's shop.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates media for a product.
- Anchor to mediamedia•[Update
Media Input!]!required A list of media updates.
- Anchor to productIdproduct•
Id ID!required Specifies the product on which media will be updated.
Arguments
- Anchor to mediamedia•
The updated media object.
- Anchor to mediaUserErrorsmedia•
User Errors [MediaUser Error!]!non-null The list of errors that occurred from executing the mutation.
- Anchor to productproduct•
The product on which media was updated.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
Anchor to InterfacesInterfaces
- •interface
- •interface
- •interface
- •interface
- •interface