Create a Shopify Product Bundle using the productBundleCreate Admin GraphQL mutation with component variant references

domain: shopify.dev · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

Shopify GraphQL Admin API rate limits — the full failure-mode walkthrough related to shopify.dev, checked against official docs, with linked verified routes.

Steps

  1. Ensure your store has the Shopify Bundles feature enabled (available as a free app on Shopify app store, or via API for Plus); obtain `write_products` Admin API access scope
  2. Call the `productBundleCreate` mutation, passing a `ProductBundleCreateInput` with `title`, `productOptions` (if the bundle has options), and `components` — an array of `ComponentInput` objects each containing a `variantId` (the component variant) and `quantity`
  3. The mutation runs asynchronously and immediately returns a `ProductBundleOperation` object with a status; poll `productOperation(id:)` query until `status` is `COMPLETE`
  4. Once complete, retrieve the bundle product ID from the operation result and use `productUpdate` or the admin UI to set pricing, images, and descriptions on the bundle parent product
  5. Activate the bundle product variant so it appears on the storefront; inventory is automatically calculated from component variants — no separate inventory entry is needed for the bundle parent
  6. Test by adding the bundle to a cart: verify component inventory decrements correctly when the bundle is purchased

Known gotchas

Related routes

Shopify product bundles via the Bundles app and productBundleCreate mutation
shopify.dev · 6 steps · unrated
Create and update Shopify subscription contracts via the Admin GraphQL API subscriptionContractCreate mutation
ecommerce-ops · 6 steps · unrated
Run a Shopify Admin GraphQL bulk mutation to update variant prices across a large catalog using stagedUploadsCreate and bulkOperationRunMutation
shopify.dev · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans