Shopify Introduces a New Collections API in 2026-07

Shopify is introducing a major update to its Collections API in the 2026-07 GraphQL Admin API release. The new model replaces the traditional split between smart collections and custom collections with a more flexible, composable system based on multiple collection sources

Shopify Introduces a New Collections API in 2026-07
5 sections

What’s New?

Instead of relying on a single ruleSet, a collection can now combine different sources, including:

  • Typed conditions for automatically matching products or variants
  • Manual product or variant selections
  • Inclusions and exclusions
  • Sub-collections that inherit products from other collections
  • App-owned collection sources that can be shared across collections
  • This creates a much more powerful collection structure.

    For example, a store could create a collection for "Summer Essentials" that combines automatically selected products, manually curated items, and products inherited from several sub-collections—all within one collection.

    Variant-Level Collections

    One of the most interesting improvements is variant-level targeting.

    Developers can now create collections that target specific variants rather than entire products. This opens up new possibilities for experiences such as:

  • Showing only red variants in a "Red Collection"
  • Creating collections for specific sizes
  • Applying promotions to selected variants
  • Building more accurate filters and swatches
  • Shopify Functions also introduces ProductVariant.inCollections and ProductVariant.inAnyCollection, making variant-level collection membership available to functions.

    What Developers Need to Do

    If you're building a Shopify app that works with collections, this update requires attention.

    Shopify recommends moving to the 2026-07 GraphQL Admin API and adopting the new sources model. Older API versions cannot represent collections that use new capabilities such as multiple sources, exclusions, sub-collections, or variant-targeted sources.

    Several legacy fields and mutations are also deprecated, including:

  • Collection.ruleSet
  • CollectionInput
  • collectionAddProducts
  • collectionRemoveProducts
  • collectionAddProductsV2
  • collectionRulesConditions
  • These remain available in 2026-07 for incremental migration, but developers should begin updating their integrations.

    What About Webhooks?

    The good news is that existing collection webhook topics remain unchanged. collections/create, collections/update, and collections/delete continue to work with the same triggers.

    Why This Matters

    The new Collections API gives Shopify developers much more flexibility when building merchandising, filtering, navigation, discount, and collection-management apps.

    Instead of thinking of a collection as simply "a list of products", developers can now treat it as a combination of dynamic sources and rules.

    This makes collections more powerful, scalable, and suitable for advanced commerce experiences.

    Final Thoughts

    The 2026-07 Collections API is a significant architectural change for Shopify developers. If your app relies heavily on collections, now is the right time to review your API implementation and start migrating from the legacy ruleSet model to the new composable sources model.

    The earlier you update your integration, the easier it will be to support the new collection capabilities—including variant-level collections, exclusions, nested collections, and app-powered sources

    Tags
    Sources

    Related Articles

    Unlock Retail Store Discovery with Shopify’s New UCP Location Search & Lookup

    Unlock Retail Store Discovery with Shopify’s New UCP Location Search & Lookup

    Shopify now lets apps locate a merchant’s physical stores via UCP location search and lookup. Learn what changed, who’s affected, and how to add the capabilities to your storefront integration.

    October 22, 20264 min
    Reactive Storage Boosts POS UI Extensions with Real‑Time Sync

    Reactive Storage Boosts POS UI Extensions with Real‑Time Sync

    Shopify’s latest POS UI extension update introduces shopify.storage.current, a reactive storage API that automatically syncs data across extension targets on the same device. Learn what changed, who it impacts, and how to implement it in minutes.

    October 22, 20264 min
    s‑pos‑list Arrives: Virtualized Lists Transform Shopify POS UI Extensions

    s‑pos‑list Arrives: Virtualized Lists Transform Shopify POS UI Extensions

    Shopify POS UI extensions get a powerful new component—s‑pos‑list—in the 2026‑10 API. Learn what changed, who it impacts, and how to adopt the virtualized list for faster, memory‑efficient rendering.

    October 22, 20264 min
    Polaris 2.0 Is Now Stable: What Shopify Developers Must Do Today

    Polaris 2.0 Is Now Stable: What Shopify Developers Must Do Today

    Polaris 2.0 has moved to the stable CDN, bringing a redesigned admin look, new semantic versioning, and updated TypeScript types. Learn how to switch script tags, update React Router apps, and keep your Shopify extensions on the latest UI framework.

    October 22, 20264 min