Collection Connection
An auto-generated type for paginating through multiple Collections.
Anchor to Fields with this connectionFields with this connection
- : deprecated
- •OBJECT
A connection between a Shopify shop and an external selling platform that supports product syndication and optionally order ingestion. Each channel binds a merchant's account on a specific platform — such as Amazon, eBay, Google, or a point-of-sale system — to the shop, establishing the publishing destination for product feeds.
Sales Channel applications use
to establish channels after merchant authentication, and can manage multiple channel connections per app. Each channel is bound to a channel specification that declares the platform's regional coverage, capabilities, and requirements.Use channels to manage where catalog items are syndicated, track publication status across platforms, and control
Productvisibility for different selling destinations.- •OBJECT
A list of collections that the discount can have as a prerequisite or a list of collections to which the discount can be applied.
- •OBJECT
The items to which this price rule applies. This may be multiple products, product variants, collections or combinations of the aforementioned.
- •OBJECT
Single or multiple line item products, product variants or collections required for the price rule to be applicable, can also be provided in combination.
- •OBJECT
The
Productobject lets you manage products in a merchant’s store.Products are the goods and services that merchants offer to customers. They can include various details such as title, description, price, images, and options such as size or color. You can use product variants to create or update different versions of the same product. You can also add or update product media. Products can be organized by grouping them into a collection.
Learn more about working with Shopify's product model, including limitations and considerations.
- •OBJECT
A group of products and collections that are published to an app.
Each publication manages which products and collections display on its associated
Channel. Merchants can automatically publish products when they're created ifis enabled, or manually control publication through publication records.Publications support scheduled publishing through future publish dates for online store channels, allowing merchants to coordinate product launches and promotional campaigns. The
catalogfield links to pricing and availability rules specific to that publication's context.- •OBJECTDeprecated
Anchor to Queries with this connectionQueries with this connection
- collections (CollectionConnection!)
- •query
Retrieves a list of collections in a store. Collections are groups of products that merchants can organize for display in their online store and other sales channels. For example, an athletics store might create different collections for running attire, shoes, and accessories.
Use the
collectionsquery when you need to:- Build a browsing interface for a store's product groupings.
- Create collection searching, sorting, and filtering experiences (for example, by title, type, or published status).
- Sync collection data with external systems.
- Manage both custom (manual) and smart (automated) collections.
The
collectionsquery supports pagination for large catalogs and saved searches for frequently used collection queries.The
collectionsquery returns collections with their associated metadata, including:- Basic collection information (title, description, handle, and type)
- Collection image and SEO metadata
- Product count and product relationships
- Collection rules (for smart collections)
- Publishing status and publication details
- Metafields and custom attributes
Learn more about using metafields with smart collections.
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to queryquery•String
A filter made up of terms, connectives, modifiers, and comparators.
name type description acceptable_values default_value example_use default string Filter by a case-insensitive search of multiple fields in a document. - query=Bob Norman
-query=title:green hoodiecollection_type string - custom
-smarthandle string id id Filter by idrange.- id:1234
-id:>=1234
-id:<=1234product_id id Filter by collections containing a product by its ID. product_publication_status string Filter by channel approval process status of the resource on a channel, such as the online store. The value is a composite of the channel appID( Channel.app.id) and one of the valid values. For simple visibility checks, use published_statusinstead. -
- `*{channel_app_id}-rejected * {channel_app_id}-needs_action`
-
- `*{channel_app_id}-published * {channel_app_id}-demoted*{channel_app_id}-scheduled *{channel_app_id}-provisionally_published` - publishable_status string Deprecated: This parameter is deprecated as of 2025-12 and will be removed in a future API version. Use published_status for visibility checks. Filter by the publishable status of the resource on a channel. The value is a composite of the [channel appID](https://shopify.dev/api/admin-graphql/latest/objects/Channel#app-price) ( Channel.app.id) and one of the valid status values.- `* {channel_app_id}-unset * {channel_app_id}-pending*{channel_app_id}-approved * {channel_app_id}-not_approved`-
-published_at time Filter by the date and time when the collection was published to the Online Store. published_status string Filter resources by their visibility and publication state on a channel. Online store channel filtering: - : Returns all resources in the online store channel,regardless of publication status. - published/visible: Returns resourcesthat are published to the online store. - unpublished: Returns resourcesthat are not published to the online store. Channel-specific filtering using a channel ID, channel handle, [channel appID](https://shopify.dev/api/admin-graphql/latest/objects/Channel#app-price) ( Channel.app.id), or app handle with suffixes: -: Returns resources published to the specifiedchannel. - : Same as(kept for backwards compatibility). - : Returnsresources added to the channel but not yet published. - : Returns resources not added to the channel or notpublished. Other: - unavailable: Returns resources not published to anychannel. -
-published
-visibleunpublished
-
-
-
-
-
-
-
-
-unavailable| | -
-
-
-
-| | title | string | | updated_at | time | You can apply one or more filters to a query. Learn more about Shopify API search syntax.
- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
- Anchor to savedSearchIdsaved•ID
Search Id The ID of a saved search. The search’s query string is used as the query argument.
- Anchor to sortKeysort•Collection
Key Sort Keys Default:ID Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.
Arguments
Anchor to Possible returnsPossible returns
- edges ([CollectionEdge!]!)
- nodes ([Collection!]!)
- pageInfo (PageInfo!)
- Anchor to edgesedges•[Collection
Edge!]! non-null The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.
- Anchor to nodesnodes•[Collection!]!non-null
A list of nodes that are contained in CollectionEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve.
- Anchor to pageInfopage•Page
Info Info! non-null An object that’s used to retrieve cursor information about the current page.