Skip to main content
mutation

Requires write_products access scope. Also: The user must have a permission to create products.

Creates a product with attributes such as title, description, vendor, and media.

The productCreate mutation helps you create many products at once, avoiding the tedious or time-consuming process of adding them one by one in the Shopify admin. Common examples include creating products for a new collection, launching a new product line, or adding seasonal products.

You can define product options and values, allowing you to create products with different variations like sizes or colors. You can also associate media files to your products, including images and videos.

The productCreate mutation only supports creating a product with its initial product variant. To create multiple product variants for a single product and manage prices, use the productVariantsBulkCreate mutation.


Note

The productCreate mutation has a throttle that takes effect when a store has 50,000 product variants. After this threshold is reached, no more than 1,000 new product variants can be created per day.


After you create a product, you can make subsequent edits to the product using one of the following mutations:

  • publishablePublish: Used to publish the product and make it available to customers. The productCreate mutation creates products in an unpublished state by default, so you must perform a separate operation to publish the product.
  • productUpdate: Used to update a single product, such as changing the product's title, description, vendor, or associated media.
  • productSet: Used to perform multiple operations on products, such as creating or modifying product options and variants.

Learn more about the product model and adding product data.

•ProductInput!
required

The properties of the new product.

•[CreateMediaInput!]

The media to add to the product.


Was this section helpful?

Anchor to ProductCreatePayload returnsProductCreatePayload returns

•Product

The product object.

•Shop!
non-null

The shop associated with the product.

•[UserError!]!
non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?