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

    Shopify agents.md.liquid: Making Your Store Ready for AI Agents
    Platform Updates

    Shopify agents.md.liquid: Making Your Store Ready for AI Agents

    Shopify is introducing agents.md.liquid, a new theme template designed to help AI agents and shopping assistants understand how to discover and interact with a Shopify store

    August 10, 20263 min
    Identity verification for Shopify Partners starts today
    Platform Updates

    Identity verification for Shopify Partners starts today

    Starting today, Shopify Partners can complete identity verification before requesting collaborator access to merchant stores. Identity verification is optional today and will become mandatory in the coming weeks before sending a new collaborator request

    August 6, 20267 min
    Recent Shopify Updates to Boost Your Store's Performance
    Platform Updates

    Recent Shopify Updates to Boost Your Store's Performance

    Discover the latest Shopify updates, including app-added annotations, WhatsApp marketing, and UPS return labels, to enhance your store's performance and customer experience. Learn how to leverage these updates to drive sales, improve analytics, and streamline operations. Get expert insights on how to implement these updates and take your Shopify store to the next level.

    August 3, 20262 min
    Developer Preview: Shopify Introduces Liquid Block and Partial Tags
    Platform Updates

    Developer Preview: Shopify Introduces Liquid Block and Partial Tags

    Shopify continues to improve the developer experience with an exciting new Developer Preview that introduces two powerful additions to Liquid: block and partial tags.

    August 2, 202615 min