---
title: SearchResultItemConnection - Storefront API
description: An auto-generated type for paginating through multiple SearchResultItems.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/connections/SearchResultItemConnection
  md: >-
    https://shopify.dev/docs/api/storefront/latest/connections/SearchResultItemConnection.md
api_name: storefront
api_type: graphql
type: connection
---

# Search​Result​Item​Connection

connection

An auto-generated type for paginating through multiple SearchResultItems.

## Queries with this connection

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

  query

  Returns paginated search results for [`Product`](https://shopify.dev/docs/api/storefront/2026-10/objects/Product), [`Page`](https://shopify.dev/docs/api/storefront/2026-10/objects/Page), and [`Article`](https://shopify.dev/docs/api/storefront/2026-10/objects/Article) resources based on a query string. Results are sorted by relevance by default.

  The response includes the total result count and available product filters for building [faceted search interfaces](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections/filter-products). A search returns up to 1,000 results. Use the [`prefix`](https://shopify.dev/docs/api/storefront/2026-10/enums/SearchPrefixQueryType) argument to enable partial word matching on the last search term, allowing queries like "winter snow" to match "snowboard" or "snowshoe".

  * after

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

    ### Arguments

    Returns the elements that come after the specified cursor.

  * before

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

    Returns the elements that come before the specified cursor.

  * first

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

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

  * last

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

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

  * prefix

    [Search​Prefix​Query​Type](https://shopify.dev/docs/api/storefront/latest/enums/SearchPrefixQueryType)

    Specifies whether to perform a partial word match on the last search term.

  * product​Filters

    [\[Product​Filter!\]](https://shopify.dev/docs/api/storefront/latest/input-objects/ProductFilter)

    Returns a subset of products matching all product filters.

    The input must not contain more than `250` values.

  * query

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

    required

    The search query.

  * reverse

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

    Default:false

    Reverse the order of the underlying list.

  * sort​Key

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

    Default:RELEVANCE

    Sort the underlying list by the given key.

  * types

    [\[Search​Type!\]](https://shopify.dev/docs/api/storefront/latest/enums/SearchType)

    The types of resources to search for.

    The input must not contain more than `250` values.

  * unavailable​Products

    [Search​Unavailable​Products​Type](https://shopify.dev/docs/api/storefront/latest/enums/SearchUnavailableProductsType)

    Specifies how unavailable products or variants are displayed in the search results.

  ***

***

## Possible returns

* edges

  [\[Search​Result​Item​Edge!\]!](https://shopify.dev/docs/api/storefront/latest/objects/SearchResultItemEdge)

  non-null

  A list of edges.

* nodes

  [\[Search​Result​Item!\]!](https://shopify.dev/docs/api/storefront/latest/unions/SearchResultItem)

  non-null

  A list of the nodes contained in SearchResultItemEdge.

* page​Info

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

  non-null

  Information to aid in pagination.

* product​Filters

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

  non-null

  A list of available filters.

* total​Count

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

  non-null

  The total number of results, up to a maximum of 1,000. If a search matches more than 1,000 results, then it returns 1,000, and pagination returns up to the first 1,000 results.

***

## Map

### Queries with this connection

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

### Possible returns

* [Search​Result​Item​Connection.edges](https://shopify.dev/docs/api/storefront/latest/connections/SearchResultItemConnection#returns-edges)
* [Search​Result​Item​Connection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/SearchResultItemConnection#returns-nodes)
* [Search​Result​Item​Connection.pageInfo](https://shopify.dev/docs/api/storefront/latest/connections/SearchResultItemConnection#returns-pageInfo)
* [Search​Result​Item​Connection.productFilters](https://shopify.dev/docs/api/storefront/latest/connections/SearchResultItemConnection#returns-productFilters)
* [Search​Result​Item​Connection.totalCount](https://shopify.dev/docs/api/storefront/latest/connections/SearchResultItemConnection#returns-totalCount)