---
title: PredictiveSearchLimitScope - Storefront API
description: Decides the distribution of results.
api_version: 2026-04
api_name: storefront
type: enum
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/enums/PredictiveSearchLimitScope
  md: >-
    https://shopify.dev/docs/api/storefront/latest/enums/PredictiveSearchLimitScope.md
---

# Predictive​Search​Limit​Scope

enum

Decides the distribution of results.

## Valid values

* ALL

  Return results up to limit across all types.

* EACH

  Return results up to limit per type.

***

## Fields

* [Query​Root.predictiveSearch(limitScope)](https://shopify.dev/docs/api/storefront/latest/objects/QueryRoot#field-QueryRoot.fields.predictiveSearch.arguments.limitScope)

  ARGUMENT

  The entry point for all Storefront API queries. Provides access to shop resources including products, collections, carts, and customer data, as well as content like articles and pages. This query acts as the public, top-level type from which all queries must start.

  Use individual queries like [`product`](https://shopify.dev/docs/api/storefront/current/queries/product) or [`collection`](https://shopify.dev/docs/api/storefront/current/queries/collection) to fetch specific resources by ID or handle. Use plural queries like [`products`](https://shopify.dev/docs/api/storefront/current/queries/products) or [`collections`](https://shopify.dev/docs/api/storefront/current/queries/collections) to retrieve paginated lists with optional filtering and sorting. The [`search`](https://shopify.dev/docs/api/storefront/current/queries/search) and [`predictiveSearch`](https://shopify.dev/docs/api/storefront/current/queries/predictiveSearch) queries enable storefront search functionality.

  Explore queries interactively with the [GraphiQL explorer and sample query kit](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/api-exploration).

* [predictive​Search.limitScope](https://shopify.dev/docs/api/storefront/latest/queries/predictiveSearch#arguments-limitScope)

  ARGUMENT

***

## Map

### Arguments with this enum

* [Query​Root.predictiveSearch(limitScope)](https://shopify.dev/docs/api/storefront/latest/objects/QueryRoot#field-QueryRoot.fields.predictiveSearch.arguments.limitScope)
* [predictive​Search.limitScope](https://shopify.dev/docs/api/storefront/latest/queries/predictiveSearch#arguments-limitScope)