---
title: PredictiveSearchResult - Storefront API
description: |
  A predictive search result represents a list of products, collections, pages, articles, and query suggestions
  that matches the predictive search query.
api_version: 2025-10
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/predictivesearchresult
  md: https://shopify.dev/docs/api/storefront/latest/objects/predictivesearchresult.md
---

# Predictive​Search​Result

object

A predictive search result represents a list of products, collections, pages, articles, and query suggestions that matches the predictive search query.

## Fields

* articles

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

  non-null

  The articles that match the search query.

* collections

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

  non-null

  The articles that match the search query.

* pages

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

  non-null

  The pages that match the search query.

* products

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

  non-null

  The products that match the search query.

* queries

  [\[Search​Query​Suggestion!\]!](https://shopify.dev/docs/api/storefront/latest/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/latest/queries/predictiveSearch)

  query

  List of the predictive search results.

  * limit

    [Int](https://shopify.dev/docs/api/storefront/latest/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/latest/enums/PredictiveSearchLimitScope)

    Decides the distribution of results.

  * query

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

    required

    The search query.

  * searchable​Fields

    [\[Searchable​Field!\]](https://shopify.dev/docs/api/storefront/latest/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/latest/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/latest/enums/SearchUnavailableProductsType)

    Specifies how unavailable products are displayed in the search results.

  ***

***

## \<?>PredictiveSearchResult Queries

### Queried by

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