6/6/2026, 12:00:37 AM
API changes: 2 queries added, 0 removed. 3 mutations added, 0 removed. 115 types affected.
Returns the shareable collection sources owned by the given app for the shop.
Returns the apps that publish shareable collection sources for the shop, paginated.
Lists all rules that can be used to create smart collections.
Returns a SubscriptionContractConnection containing subscription contracts. Subscription contracts are agreements between customers and merchants for recurring purchases with defined billing and delivery schedules.
Filter results with the query argument. You can paginate results using standard cursor-based pagination.
Creates a shareable collection source that can later be linked to one or more collections.
Deletes a shareable collection source owned by the calling app. If the source is linked to collections, it will be unlinked from all of them.
Updates a shareable collection source owned by the calling app.
Creates a collection
to group products together
in the online store and
other sales channels.
For example, an athletics store might create different collections for running attire, shoes, and accessories.
There are two types of collections:
Use the collectionCreate mutation when you need to:
Note:
The created collection is unpublished by default. To make it available to customers,
use thepublishablePublish
mutation after creation.
Learn more about using metafields with smart collections.
Updates a collection,
modifying its properties, products, or publication settings. Collections help organize
products together
in the online store and
other sales channels.
Use the collectionUpdate mutation to programmatically modify collections in scenarios such as:
There are two types of collections with different update capabilities:
job object that you can use to track the progress of the update.To publish or unpublish collections to specific sales channels, use the dedicatedpublishablePublish andpublishableUnpublish mutations.
Learn more about using metafields with smart collections.
Specifies whether products must match any or all conditions to be included in the collection.
A collection source that uses conditions and selections to determine which products are included.
An auto-generated type for paginating through multiple CollectionConditionsSources.
Return type for collectionConditionsSourceCreate mutation.
Return type for collectionConditionsSourceDelete mutation.
An auto-generated type which holds one CollectionConditionsSource and a cursor during pagination.
The set of valid sort keys for the CollectionConditionsSource query.
Return type for collectionConditionsSourceUpdate mutation.
An app together with the shareable collection sources it publishes for the shop.
An auto-generated type for paginating through multiple CollectionConditionsSourcesByApps.
An auto-generated type which holds one CollectionConditionsSourcesByApp and a cursor during pagination.
The input fields required to create a collection source.
The input fields required to create a collection.
The input fields for creating exclusion rules for a collection source.
The input fields for creating inclusion rules for a collection source.
The input fields for adding a source to a collection — provide exactly one field that represents the type of source to create.
The input fields required to create a sub-collection source — a source whose membership comes from a single referenced collection.
The input fields for selecting specific products to exclude from a collection.
Represents a product that has been manually selected for inclusion in a collection.
An auto-generated type for paginating through multiple CollectionInclusionProductSelections.
An auto-generated type which holds one CollectionInclusionProductSelection and a cursor during pagination.
The input fields for selecting specific products to include in a collection.
A source that provides products for a collection.
The input fields for a condition that determines which products are excluded from a collection. Exactly one condition type must be provided.
The input fields for an exclusion condition based on product categories.
The relation for comparing product categories in exclusion conditions.
The input fields for a product category value in an exclusion condition.
The input fields for an exclusion condition based on product tags.
The relationship between the product tag and the condition values.
The input fields for an exclusion condition based on product types.
The relation for comparing product types in exclusion conditions.
The input fields for an exclusion condition based on product vendors.
The relation for comparing product vendors in exclusion conditions.
The input fields for an exclusion condition based on variant titles.
The relation for comparing variant titles in exclusion conditions.
Defines the rules and selections for including products in a collection.
A condition that determines which products should be included in a collection.
The input fields for a condition that determines which products are included in a collection. Exactly one condition type must be provided.
A condition based on whether a product has a reduced price for including products in a collection.
The input fields for a condition based on whether a product has a reduced price.
The relation for comparing whether a product has a reduced price.
A condition that determines which products should be included in a collection.
A condition based on boolean metafield values for including products in a collection.
The input fields for a condition based on boolean metafield values.
The relation for comparing boolean metafield values.
A condition based on decimal metafield values for including products in a collection.
The input fields for a condition based on decimal metafield values.
The relation for comparing decimal metafield values.
A condition based on integer metafield values for including products in a collection.
The input fields for a condition based on integer metafield values.
The relation for comparing integer metafield values.
A condition based on single metaobject reference metafield values for including products in a collection.
The input fields for a condition based on single metaobject reference metafield values.
A condition based on list of metaobject reference metafield values for including products in a collection.
The input fields for a condition based on metaobject list reference metafield values.
The relationship between the metaobject value and the condition values.
The relation for comparing metaobject metafield values.
A condition based on string metafield values for including products in a collection.
The input fields for a condition based on string metafield values.
A condition based on list of string metafield values for including products in a collection.
The input fields for a condition based on string list metafield values.
The relationship between the metafield value and the condition values.
The relationship between the metafield value and the condition values.
A condition based on product category IDs for including products in a collection.
The input fields for a condition based on product categories.
The relation for comparing product category IDs.
A value for a product category condition.
The input fields for a product category value in a collection condition.
A condition based on product status for including products in a collection.
The input fields for a condition based on product status.
The relation for comparing product status.
A condition based on product tags for including products in a collection.
The input fields for a condition based on product tags.
The relationship between the product tag and the condition values.
A condition based on product titles for including products in a collection.
The input fields for a condition based on product titles.
The relationship between the product title and the condition values.
A condition based on product types for including products in a collection.
The input fields for a condition based on product types.
The relation for comparing product types.
A condition based on product vendors for including products in a collection.
The input fields for a condition based on product vendors.
The relation for comparing product vendors.
An inclusion condition introduced in a newer API version that is not modeled by this version of the API. Clients should treat the relation and values as opaque strings.
A condition based on variant compare at prices for including products in a collection.
The input fields for a condition based on variant compare at prices.
The relation for comparing variant compare at prices.
A condition based on variant inventory quantities for including products in a collection.
The input fields for a condition based on variant inventory quantities.
The relation for comparing variant inventory quantities.
A condition based on variant prices for including products in a collection.
The input fields for a condition based on variant prices.
The relation for comparing variant prices.
A condition based on variant titles for including products in a collection.
The input fields for a condition based on variant titles.
The relation for comparing variant titles.
A condition based on variant weights for including products in a collection.
The input fields for a condition based on variant weights.
The relation for comparing variant weights.
Conditions that target variants cause either the entire product to be included when satisfied or only the matching variants.
A collection source whose membership comes from a single referenced collection (sub-collection).
Sub-collection sources are always non-shareable: the inherited shareable field on the CollectionSource
interface always resolves to false for this type. Sharing a sub-collection source across owners is not
supported because the chain reference is owner-bound.
The input fields for updating a shareable collection source.
The input fields required to update a collection.
The input fields for updating an exclusion condition in a collection source.
The input fields for updating exclusion rules for a collection source.
The input fields for updating a condition in a collection source.
The input fields for updating inclusion rules for a collection source.
A cash out transaction where the gift card balance was redeemed for cash.
The attribution details for an order.
sourcesThe sources that provide products for this collection. Each source represents a way products are included in the collection, such as through conditions and rules.
issuanceCurrencyMARKET_UPDATE_CONCURRENT_MODIFICATIONattributionThe attribution details for the order.
buyerExperienceDepositEnabledWhether the buyer experience deposit configuration is enabled.
directConnectionCatalogAssignmentEnabledWhether the direct connection catalog assignment is enabled.
MACHINE_TRANSLATION_BATCH_COMPLETED