--- title: ProductConnection - GraphQL Admin description: An auto-generated type for paginating through multiple Products. api_version: 2025-01 api_name: admin type: connection api_type: graphql source_url: html: >- https://shopify.dev/docs/api/admin-graphql/2025-01/connections/ProductConnection md: >- https://shopify.dev/docs/api/admin-graphql/2025-01/connections/ProductConnection.md --- # Product​Connection connection An auto-generated type for paginating through multiple Products. ## Fields with this connection * [Channel.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Channel#field-Channel.fields.products) OBJECT A channel represents an app where you sell a group of products and collections. A channel can be a platform or marketplace such as Facebook or Pinterest, an online store, or POS. * [Collection.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Collection#field-Collection.fields.products) OBJECT The `Collection` object represents a group of [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) that merchants can organize to make their stores easier to browse and help customers find related products. Collections serve as the primary way to categorize and display products across [online stores](https://shopify.dev/docs/apps/build/online-store), [sales channels](https://shopify.dev/docs/apps/build/sales-channels), and marketing campaigns. There are two types of collections: * **[Custom (manual) collections](https://help.shopify.com/manual/products/collections/manual-shopify-collection)**: You specify the products to include in a collection. * **[Smart (automated) collections](https://help.shopify.com/manual/products/collections/automated-collections)**: You define rules, and products matching those rules are automatically included in the collection. The `Collection` object provides information to: * Organize products by category, season, or promotion. * Automate product grouping using rules (for example, by tag, type, or price). * Configure product sorting and display order (for example, alphabetical, best-selling, price, or manual). * Manage collection visibility and publication across sales channels. * Add rich descriptions, images, and metadata to enhance discovery. *** Note Collections are unpublished by default. To make them available to customers, use the [`publishablePublish`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publishablePublish) mutation after creation. *** Collections can be displayed in a store with Shopify's theme system through [Liquid templates](https://shopify.dev/docs/storefronts/themes/architecture/templates/collection) and can be customized with [template suffixes](https://shopify.dev/docs/storefronts/themes/architecture/templates/alternate-templates) for unique layouts. They also support advanced features like translated content, resource feedback, and contextual publication for location-based catalogs. Learn about [using metafields with smart collections](https://shopify.dev/docs/apps/build/custom-data/metafields/use-metafield-capabilities). * [Discount​Products.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/DiscountProducts#field-DiscountProducts.fields.products) OBJECT A list of products and product variants that the discount can have as a prerequisite or a list of products and product variants to which the discount can be applied. * [Price​Rule​Item​Entitlements.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PriceRuleItemEntitlements#field-PriceRuleItemEntitlements.fields.products) OBJECT The items to which this price rule applies. This may be multiple products, product variants, collections or combinations of the aforementioned. * [Price​Rule​Line​Item​Prerequisites.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PriceRuleLineItemPrerequisites#field-PriceRuleLineItemPrerequisites.fields.products) 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. * [Publication.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Publication#field-Publication.fields.products) OBJECT A publication is a group of products and collections that is published to an app. * [Selling​Plan​Group.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/SellingPlanGroup#field-SellingPlanGroup.fields.products) OBJECT Represents a selling method (for example, "Subscribe and save" or "Pre-paid"). Selling plan groups and associated records (selling plans and policies) are deleted 48 hours after a merchant uninstalls their subscriptions app. We recommend backing up these records if you need to restore them later. * [Shop.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Shop#field-Shop.fields.products) OBJECT Deprecated *** ## Queries with this connection * [products](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/products) query Retrieves a list of [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) in a store. Products are the items that merchants can sell in their store. Use the `products` query when you need to: * Build a browsing interface for a product catalog. * Create product [searching](https://shopify.dev/docs/api/usage/search-syntax), [sorting](https://shopify.dev/docs/api/admin-graphql/latest/queries/products#arguments-sortKey), and [filtering](https://shopify.dev/docs/api/admin-graphql/latest/queries/products#arguments-query) experiences. * Implement product recommendations. * Sync product data with external systems. The `products` query supports [pagination](https://shopify.dev/docs/api/usage/pagination-graphql) to handle large product catalogs and [saved searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/products#arguments-savedSearchId) for frequently used product queries. The `products` query returns products with their associated metadata, including: * Basic product information (for example, title, description, vendor, and type) * Product options and product variants, with their prices and inventory * Media attachments (for example, images and videos) * SEO metadata * Product categories and tags * Product availability and publishing statuses Learn more about working with [Shopify's product model](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components). *** ## Possible returns * edges [\[Product​Edge!\]!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/ProductEdge) non-null The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node. * nodes [\[Product!\]!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Product) non-null A list of nodes that are contained in ProductEdge. 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. * page​Info [Page​Info!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PageInfo) non-null An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. *** ## Map ### Fields with this connection * {}[Channel.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Channel#field-Channel.fields.products) * {}[Collection.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Collection#field-Collection.fields.products) * {}[Discount​Products.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/DiscountProducts#field-DiscountProducts.fields.products) * {}[Price​Rule​Item​Entitlements.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PriceRuleItemEntitlements#field-PriceRuleItemEntitlements.fields.products) * {}[Price​Rule​Line​Item​Prerequisites.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PriceRuleLineItemPrerequisites#field-PriceRuleLineItemPrerequisites.fields.products) * {}[Publication.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Publication#field-Publication.fields.products) * {}[Selling​Plan​Group.products](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/SellingPlanGroup#field-SellingPlanGroup.fields.products) ### Queries with this connection * \[products](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/products) ### Possible returns * <->[Product​Connection.edges](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/ProductConnection#returns-edges) * <->[Product​Connection.nodes](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/ProductConnection#returns-nodes) * <->[Product​Connection.pageInfo](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/ProductConnection#returns-pageInfo)