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

    Local Delivery Orders Now Available Directly in Shopify POS

    Local Delivery Orders Now Available Directly in Shopify POS

    Shopify POS 11.16+ lets staff create local delivery orders at checkout, using existing delivery zones and rates. Learn what changed, who’s impacted, and how to enable this feature today.

    September 28, 20265 min
    Unlock Deeper Insights: Use Metaobject Fields Directly in Shopify Analytics

    Unlock Deeper Insights: Use Metaobject Fields Directly in Shopify Analytics

    Shopify now lets you pull metaobject data—like designer country, warranty terms, or loyalty tiers—into Analytics reports. Learn what changed, who it impacts, and how to enable and use this powerful new feature.

    September 28, 20264 min
    Category Metafields Now Power Your Shopify Analytics

    Category Metafields Now Power Your Shopify Analytics

    Shopify merchants can finally see category attributes like color, material, and fit directly in Analytics. Learn what changed, who it impacts, and how to start using these new dimensions today.

    September 28, 20264 min
    Sidekick Now Invokes App Intents Without Tools – What Developers Need to Know

    Sidekick Now Invokes App Intents Without Tools – What Developers Need to Know

    Shopify’s Sidekick can now surface intent‑only extensions, eliminating the need for a tools file. Learn which apps are affected, how validation changes, and the exact steps to keep your app deployable.

    September 28, 20264 min