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 Transparency: The New Store Activity Log Lets You Track Every Change

    Unlock Transparency: The New Store Activity Log Lets You Track Every Change

    Shopify’s rebuilt Store activity log centralizes every modification—from products to payments—into one searchable timeline. Learn what’s new, who can see it, and how merchants and developers can act today.

    November 13, 20264 min
    Custom Draft Order Discounts Now Respect Presentment Currency

    Custom Draft Order Discounts Now Respect Presentment Currency

    Shopify now calculates custom draft‑order discounts in the draft’s presentment currency instead of the shop’s default. Learn what this means for merchants, developers, and how to update your workflow today.

    November 13, 20264 min
    Checkout Functions Get Smarter: `cart.deliverableLine` Now Includes Cost Modeling and Direct Cart Line Links

    Checkout Functions Get Smarter: `cart.deliverableLine` Now Includes Cost Modeling and Direct Cart Line Links

    Shopify’s latest checkout function update adds cost modeling to `cart.deliverableLine` inputs and ties them directly to their originating cart lines. Learn what this means for developers, how to adjust your code, and the best practices to stay compliant.

    November 13, 20264 min
    Case-Insensitive Market Metafields: What the 2027-01 Storefront API Change Means for Your Store

    Case-Insensitive Market Metafields: What the 2027-01 Storefront API Change Means for Your Store

    Shopify's Storefront API 2027-01 now matches Market.metafields keys case‑insensitively. Learn why this matters, who is affected, and how to update your apps and custom storefronts before the change breaks your logic.

    November 13, 20264 min