Skip to main content
Anchor to ProductVariantsBulkCreateUserError

ProductVariantsBulkCreateUserError

object

Requires read_products access scope.

Error codes for failed product variant bulk create mutations.

•ProductVariantsBulkCreateUserErrorCode

The error code.

•[String!]

The path to the input field that caused the error.

•String!
non-null

The error message.


Was this section helpful?

•mutation

Creates multiple product variants for a single product in one operation. You can run this mutation directly or as part of a bulk operation for large-scale catalog updates.

Use the productVariantsBulkCreate mutation to efficiently add new product variants—such as different sizes, colors, or materials—to an existing product. The mutation is helpful if you need to add product variants in bulk, such as importing from an external system.

The mutation supports:

  • Creating variants with custom options and values
  • Associating media (for example, images, videos, and 3D models) with the product or its variants
  • Handling complex product configurations

Note

By default, stores have a limit of 100 product variants for each product. You can create a development store and enable the Extended Variants developer preview to create a maximum of 2,048 product variants in a single operation.


After creating variants, you can make additional changes using one of the following mutations:

  • productVariantsBulkUpdate: Updates multiple product variants for a single product in one operation.
  • productSet: Used to perform multiple operations on products, such as creating or modifying product options and variants.

You can also specifically manage product options through related mutations:

Learn more about the product model and adding product data.

Arguments

•[CreateMediaInput!]

List of new media to be added to the product.

•ID!
required

The ID of the product on which to create the variants.

•ProductVariantsBulkCreateStrategy
Default: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.

•[ProductVariantsBulkInput!]!
required

An array of product variants to be created.


Fields

•Product

The updated product object.

•[ProductVariant!]

The newly created variants.

•[ProductVariantsBulkCreateUserError!]!
non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?


Was this section helpful?