---
title: ProductConnection - Storefront API
description: |
  An auto-generated type for paginating through multiple Products.
api_version: 2025-10
api_name: storefront
type: connection
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/connections/productconnection
  md: https://shopify.dev/docs/api/storefront/latest/connections/productconnection.md
---

# Product​Connection

connection

An auto-generated type for paginating through multiple Products.

## Fields with this connection

* [Collection.products](https://shopify.dev/docs/api/storefront/latest/objects/Collection#field-Collection.fields.products)

  OBJECT

  A collection represents a grouping of products that a shop owner can create to organize them or make their shops easier to browse.

***

## Queries with this connection

* [products](https://shopify.dev/docs/api/storefront/latest/queries/products)

  query

  Returns a list of the shop's products. For storefront search, use the [`search`](https://shopify.dev/docs/api/storefront/latest/queries/search) query.

  * first

    [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

    ### Arguments

    Returns up to the first `n` elements from the list.

  * after

    [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

    Returns the elements that come after the specified cursor.

  * last

    [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

    Returns up to the last `n` elements from the list.

  * before

    [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

    Returns the elements that come before the specified cursor.

  * reverse

    [Boolean](https://shopify.dev/docs/api/storefront/latest/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  * sort​Key

    [Product​Sort​Keys](https://shopify.dev/docs/api/storefront/latest/enums/ProductSortKeys)

    Default:ID

    Sort the underlying list by the given key.

  * query

    [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

    You can apply one or multiple filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax).

    * available\_for\_sale

      Filter by products that have at least one product variant available for sale.

    * * created\_at

      * product\_type

      * tag

      * tag\_not

      * title

      * updated\_at

      * variants.price

      - Filter by the date and time when the product was created.

      - Example:

        * `created_at:>'2020-10-21T23:39:20Z'`
        * `created_at:<now`
        * `created_at:<=2024`

        Filter by a comma-separated list of [product types](https://help.shopify.com/en/manual/products/details/product-type).

      - Example:

        * `product_type:snowboard`

        Filter products by the product [`tags`](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-tags) field.

      - Example:

        * `tag:my_tag`

        Filter by products that don't have the specified product [tags](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-tags).

      - Example:

        * `tag_not:my_tag`

        Filter by the product [`title`](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-title) field.

      - Example:

        * `title:The Minimal Snowboard`

        Filter by the date and time when the product was last updated.

      - Example:

        * `updated_at:>'2020-10-21T23:39:20Z'`
        * `updated_at:<now`
        * `updated_at:<=2024`

        Filter by the price of the product's variants.

    * vendor

      Filter by the product [`vendor`](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-vendor) field.

      Example:

      * `vendor:Snowdevil`
      * `vendor:Snowdevil OR vendor:Icedevil`

  ***

***

## Possible returns

* edges

  [\[Product​Edge!\]!](https://shopify.dev/docs/api/storefront/latest/objects/ProductEdge)

  non-null

  A list of edges.

* filters

  [\[Filter!\]!](https://shopify.dev/docs/api/storefront/latest/objects/Filter)

  non-null

  A list of available filters.

* nodes

  [\[Product!\]!](https://shopify.dev/docs/api/storefront/latest/objects/Product)

  non-null

  A list of the nodes contained in ProductEdge.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/storefront/latest/objects/PageInfo)

  non-null

  Information to aid in pagination.

***

## Map

### Fields with this connection

* {}[Collection.products](https://shopify.dev/docs/api/storefront/latest/objects/Collection#field-Collection.fields.products)

### Queries with this connection

* \<?>[products](https://shopify.dev/docs/api/storefront/latest/queries/products)

### Possible returns

* <->[Product​Connection.edges](https://shopify.dev/docs/api/storefront/latest/connections/ProductConnection#returns-edges)
* <->[Product​Connection.filters](https://shopify.dev/docs/api/storefront/latest/connections/ProductConnection#returns-filters)
* <->[Product​Connection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/ProductConnection#returns-nodes)
* <->[Product​Connection.pageInfo](https://shopify.dev/docs/api/storefront/latest/connections/ProductConnection#returns-pageInfo)