Shopify Introduces Multi-Source Collection Model in 2026-07 API Release

Shopify has released a new collection architecture in API version 2026-07 that replaces the single ruleSet structure with a multi-source model in the GraphQL Admin API.

What Changed

Collections now support multiple CollectionSource objects instead of a single ruleSet. Each source defines typed inclusion and exclusion conditions along with manual product selections. The update also adds variant-level collection membership fields to the ProductVariant type in Shopify Functions, allowing developers to check collection membership at the variant level rather than only at the product level.

Collections using the new sources model appear in standard collection queries, collection(id:) lookups, and other collection-related API endpoints in version 2026-07 and later.

Impact for Developers

Apps that manage collections or query collection data need to update their integration logic to handle the new multi-source structure. The change affects any app that creates, modifies, or reads collection rules through the Admin API.

Developers building merchandising tools, collection managers, or product organization features can now implement more complex collection logic by combining multiple sources. Apps using Shopify Functions gain new capabilities for variant-specific collection targeting in discount and checkout customizations.

Migration Considerations

Existing apps using the ruleSet model continue to function in earlier API versions. Developers should test collection queries and mutations against the 2026-07 API to identify required code changes. Apps that rely on collection membership checks in Shopify Functions should evaluate whether variant-level fields provide additional functionality for their use cases.

Read the full announcement →