Choose a version:

productVariantsBulkDelete

mutation

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

Deletes multiple variants in a single Product. Specify the product ID and an array of variant IDs to remove variants in bulk. You can call this mutation directly or through the bulkOperationRunMutation mutation. Returns the updated product and any UserError objects.

Anchor to Arguments

Arguments

Anchor to productIdproductId •ID! required: The ID of the product with the variants to update.
Anchor to variantsIdsvariantsIds •[ID!]! required: An array of product variants IDs to delete.

Was this section helpful?

Anchor to ProductVariantsBulkDeletePayload returnsProductVariantsBulkDeletePayload returns

Anchor to productproduct •Product: The updated product object.
Anchor to userErrorsuserErrors •[ProductVariantsBulkDeleteUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Bulk delete multiple product variants.

Query

mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
  productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}

Variables

{
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/113711323"
  ]
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) { productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) { product { id title } userErrors { field message } } }",
 "variables": {
    "productId": "gid://shopify/Product/20995642",
    "variantsIds": [
      "gid://shopify/ProductVariant/30322695",
      "gid://shopify/ProductVariant/113711323"
    ]
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
    productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
      product {
        id
        title
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "productId": "gid://shopify/Product/20995642",
        "variantsIds": [
            "gid://shopify/ProductVariant/30322695",
            "gid://shopify/ProductVariant/113711323"
        ]
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
    productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
      product {
        id
        title
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/113711323"
  ]
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
      productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
        product {
          id
          title
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "productId": "gid://shopify/Product/20995642",
        "variantsIds": [
            "gid://shopify/ProductVariant/30322695",
            "gid://shopify/ProductVariant/113711323"
        ]
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
  productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/113711323"
  ]
}'

Response

{
  "productVariantsBulkDelete": {
    "product": {
      "id": "gid://shopify/Product/20995642",
      "title": "Element"
    },
    "userErrors": []
  }
}

Remove an existing Product Variant

Query

mutation ProductVariantsDelete($productId: ID!, $variantsIds: [ID!]!) {
  productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}

Variables

{
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/113711323"
  ]
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation ProductVariantsDelete($productId: ID!, $variantsIds: [ID!]!) { productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) { product { id title } userErrors { field message } } }",
 "variables": {
    "productId": "gid://shopify/Product/20995642",
    "variantsIds": [
      "gid://shopify/ProductVariant/30322695",
      "gid://shopify/ProductVariant/113711323"
    ]
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation ProductVariantsDelete($productId: ID!, $variantsIds: [ID!]!) {
    productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
      product {
        id
        title
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "productId": "gid://shopify/Product/20995642",
        "variantsIds": [
            "gid://shopify/ProductVariant/30322695",
            "gid://shopify/ProductVariant/113711323"
        ]
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation ProductVariantsDelete($productId: ID!, $variantsIds: [ID!]!) {
    productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
      product {
        id
        title
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/113711323"
  ]
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation ProductVariantsDelete($productId: ID!, $variantsIds: [ID!]!) {
      productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
        product {
          id
          title
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "productId": "gid://shopify/Product/20995642",
        "variantsIds": [
            "gid://shopify/ProductVariant/30322695",
            "gid://shopify/ProductVariant/113711323"
        ]
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation ProductVariantsDelete($productId: ID!, $variantsIds: [ID!]!) {
  productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/113711323"
  ]
}'

Response

{
  "productVariantsBulkDelete": {
    "product": {
      "id": "gid://shopify/Product/20995642",
      "title": "Element"
    },
    "userErrors": []
  }
}

Returns an error if any of the product variants does not belong to the product.

Query

mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
  productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}

Variables

{
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/-1"
  ]
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) { productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) { product { id title } userErrors { field message } } }",
 "variables": {
    "productId": "gid://shopify/Product/20995642",
    "variantsIds": [
      "gid://shopify/ProductVariant/30322695",
      "gid://shopify/ProductVariant/-1"
    ]
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
    productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
      product {
        id
        title
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "productId": "gid://shopify/Product/20995642",
        "variantsIds": [
            "gid://shopify/ProductVariant/30322695",
            "gid://shopify/ProductVariant/-1"
        ]
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
    productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
      product {
        id
        title
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/-1"
  ]
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
      productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
        product {
          id
          title
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "productId": "gid://shopify/Product/20995642",
        "variantsIds": [
            "gid://shopify/ProductVariant/30322695",
            "gid://shopify/ProductVariant/-1"
        ]
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
  productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/-1"
  ]
}'

Response

{
  "productVariantsBulkDelete": {
    "product": null,
    "userErrors": [
      {
        "field": [
          "variantsIds",
          "1"
        ],
        "message": "At least one variant does not belong to the product"
      }
    ]
  }
}

productVariantsBulkDelete reference

Examples

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {

productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {

product {

title

}

userErrors {

field

message

}

}`,

{

variables: {

"productId": "gid://shopify/Product/20995642",

"variantsIds": [

"gid://shopify/ProductVariant/30322695",

"gid://shopify/ProductVariant/113711323"

]

);

const json = await response.json();

return json.data;

}

GQL

mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
  productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) { productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) { product { id title } userErrors { field message } } }",
 "variables": {
    "productId": "gid://shopify/Product/20995642",
    "variantsIds": [
      "gid://shopify/ProductVariant/30322695",
      "gid://shopify/ProductVariant/113711323"
    ]
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
    productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
      product {
        id
        title
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "productId": "gid://shopify/Product/20995642",
        "variantsIds": [
            "gid://shopify/ProductVariant/30322695",
            "gid://shopify/ProductVariant/113711323"
        ]
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
      productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
        product {
          id
          title
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "productId": "gid://shopify/Product/20995642",
        "variantsIds": [
            "gid://shopify/ProductVariant/30322695",
            "gid://shopify/ProductVariant/113711323"
        ]
    },
  },
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
    productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
      product {
        id
        title
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/113711323"
  ]
}

response = client.query(query: query, variables: variables)

Shopify CLI

shopify app execute \
--query \
'mutation bulkDeleteProductVariants($productId: ID!, $variantsIds: [ID!]!) {
  productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "productId": "gid://shopify/Product/20995642",
  "variantsIds": [
    "gid://shopify/ProductVariant/30322695",
    "gid://shopify/ProductVariant/113711323"
  ]
}'

Input variables

JSON

{

"productId": "gid://shopify/Product/20995642",

"variantsIds": [

"gid://shopify/ProductVariant/30322695",

"gid://shopify/ProductVariant/113711323"

]

}

Response

JSON

{

"productVariantsBulkDelete": {

"product": {

"id": "gid://shopify/Product/20995642",

"title": "Element"

"userErrors": []

}