Choose a version:

productVariantsBulkReorder

mutation

Requires write_products access scope. Also: The user must have a permission to reorder product variants.

Reorders multiple variants in a single product. This mutation can be called directly or via the bulkOperation.

Anchor to Arguments

Arguments

Anchor to positionspositions

•[ProductVariantPositionInput!]!

required

An array of variant positions.

Show input fields

Anchor to productIdproductId

•ID!

required

The product ID of the variants to be reordered.

Was this section helpful?

Anchor to ProductVariantsBulkReorderPayload returnsProductVariantsBulkReorderPayload returns

Anchor to productproduct •Product: The updated product.

Show fields
Anchor to userErrorsuserErrors •[ProductVariantsBulkReorderUserError!]! non-null: The list of errors that occurred from executing the mutation.

Show fields

Was this section helpful?

Examples

productVariantsBulkReorder reference

Mutation Reference

mutation productVariantsBulkReorder($positions: [ProductVariantPositionInput!]!, $productId: ID!) {

productVariantsBulkReorder(positions: $positions, productId: $productId) {

product {

# Product fields

}

userErrors {

field

message

}

Input

{

"positions": [

{

"id": "gid://shopify/ProductVariant/10079785100",

"position": 1

}

"productId": "gid://shopify/Product/10079785100"

}

Variables

{
  "positions": [
    {
      "id": "gid://shopify/ProductVariant/10079785100",
      "position": 1
    }
  ],
  "productId": "gid://shopify/Product/10079785100"
}

Schema

input ProductVariantPositionInput {
  id: ID!
  position: Int!
}