---
title: PredictiveSearchResult - Storefront API
description: >
  Returned by the
  [`predictiveSearch`](/docs/api/storefront/unstable/queries/predictiveSearch)
  query to power type-ahead search experiences. Includes matching
  [`Product`](/docs/api/storefront/unstable/objects/Product),
  [`Collection`](/docs/api/storefront/unstable/objects/Collection),
  [`Page`](/docs/api/storefront/unstable/objects/Page), and
  [`Article`](/docs/api/storefront/unstable/objects/Article) objects, along with
  query suggestions that help customers refine their search.
api_version: unstable
api_name: storefront
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/unstable/objects/PredictiveSearchResult
  md: >-
    https://shopify.dev/docs/api/storefront/unstable/objects/PredictiveSearchResult.md
---

# Predictive​Search​Result

object

Returned by the [`predictiveSearch`](https://shopify.dev/docs/api/storefront/unstable/queries/predictiveSearch) query to power type-ahead search experiences. Includes matching [`Product`](https://shopify.dev/docs/api/storefront/unstable/objects/Product), [`Collection`](https://shopify.dev/docs/api/storefront/unstable/objects/Collection), [`Page`](https://shopify.dev/docs/api/storefront/unstable/objects/Page), and [`Article`](https://shopify.dev/docs/api/storefront/unstable/objects/Article) objects, along with query suggestions that help customers refine their search.

## Fields

* articles

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

  non-null

  The articles that match the search query.

* collections

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

  non-null

  The articles that match the search query.

* pages

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

  non-null

  The pages that match the search query.

* products

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

  non-null

  The products that match the search query.

* queries

  [\[Search​Query​Suggestion!\]!](https://shopify.dev/docs/api/storefront/unstable/objects/SearchQuerySuggestion)

  non-null

  The query suggestions that are relevant to the search query.

***

## Map

No referencing types

***

## Queries

* [predictive​Search](https://shopify.dev/docs/api/storefront/unstable/queries/predictiveSearch)

  query

  Returns suggested results as customers type in a search field, enabling type-ahead search experiences. The query matches [products](https://shopify.dev/docs/api/storefront/unstable/objects/Product), [collections](https://shopify.dev/docs/api/storefront/unstable/objects/Collection), [pages](https://shopify.dev/docs/api/storefront/unstable/objects/Page), and [articles](https://shopify.dev/docs/api/storefront/unstable/objects/Article) based on partial search terms, and also provides [search query suggestions](https://shopify.dev/docs/api/storefront/unstable/objects/SearchQuerySuggestion) to help customers refine their search.

  You can filter results by resource type and limit the quantity. The [`limitScope`](https://shopify.dev/docs/api/storefront/unstable/queries/predictiveSearch#arguments-limitScope) argument controls whether limits apply across all result types or per type. Use [`unavailableProducts`](https://shopify.dev/docs/api/storefront/unstable/queries/predictiveSearch#arguments-unavailableProducts) to control how out-of-stock products appear in results.

  * limit

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

    ### Arguments

    Limits the number of results based on `limit_scope`. The value can range from 1 to 10, and the default is 10.

  * limit​Scope

    [Predictive​Search​Limit​Scope](https://shopify.dev/docs/api/storefront/unstable/enums/PredictiveSearchLimitScope)

    Decides the distribution of results.

  * query

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

    required

    The search query.

  * searchable​Fields

    [\[Searchable​Field!\]](https://shopify.dev/docs/api/storefront/unstable/enums/SearchableField)

    Specifies the list of resource fields to use for search. The default fields searched on are TITLE, PRODUCT\_TYPE, VARIANT\_TITLE, and VENDOR. For the best search experience, you should search on the default field set.

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

  * types

    [\[Predictive​Search​Type!\]](https://shopify.dev/docs/api/storefront/unstable/enums/PredictiveSearchType)

    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/unstable/enums/SearchUnavailableProductsType)

    Specifies how unavailable products are displayed in the search results.

  ***

***

## PredictiveSearchResult Queries

### Queried by

* [predictive​Search](https://shopify.dev/docs/api/storefront/unstable/queries/predictiveSearch)