---
title: SearchQuerySuggestion - Storefront API
description: |
  A suggested search term returned by the [`predictiveSearch`](/docs/api/storefront/2025-04/queries/predictiveSearch) query. Query suggestions help customers refine their searches by showing relevant terms as they type.

  The [`text`](/docs/api/storefront/2025-04/objects/SearchQuerySuggestion#field-SearchQuerySuggestion.fields.text) field provides the plain suggestion, while [`styledText`](/docs/api/storefront/2025-04/objects/SearchQuerySuggestion#field-SearchQuerySuggestion.fields.styledText) includes HTML tags to highlight matching portions. Implements [`Trackable`](/docs/api/storefront/2025-04/interfaces/Trackable) for analytics reporting on search traffic origins.
api_version: 2025-04
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/2025-04/objects/searchquerysuggestion
  md: https://shopify.dev/docs/api/storefront/2025-04/objects/searchquerysuggestion.md
---

# Search​Query​Suggestion

object

A suggested search term returned by the [`predictiveSearch`](https://shopify.dev/docs/api/storefront/2025-04/queries/predictiveSearch) query. Query suggestions help customers refine their searches by showing relevant terms as they type.

The [`text`](https://shopify.dev/docs/api/storefront/2025-04/objects/SearchQuerySuggestion#field-SearchQuerySuggestion.fields.text) field provides the plain suggestion, while [`styledText`](https://shopify.dev/docs/api/storefront/2025-04/objects/SearchQuerySuggestion#field-SearchQuerySuggestion.fields.styledText) includes HTML tags to highlight matching portions. Implements [`Trackable`](https://shopify.dev/docs/api/storefront/2025-04/interfaces/Trackable) for analytics reporting on search traffic origins.

## Fields

* styled​Text

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

  non-null

  The text of the search query suggestion with highlighted HTML tags.

* text

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

  non-null

  The text of the search query suggestion.

* tracking​Parameters

  [String](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

  URL parameters to be added to a page URL to track the origin of on-site search traffic for [analytics reporting](https://help.shopify.com/manual/reports-and-analytics/shopify-reports/report-types/default-reports/behaviour-reports). Returns a result when accessed through the [search](https://shopify.dev/docs/api/storefront/2025-04/queries/search) or [predictiveSearch](https://shopify.dev/docs/api/storefront/2025-04/queries/predictiveSearch) queries, otherwise returns null.

***

## Map

### Fields with this object

* [PredictiveSearchResult.queries](https://shopify.dev/docs/api/storefront/2025-04/objects/PredictiveSearchResult#field-PredictiveSearchResult.fields.queries)

***

## Interfaces

* [Trackable](https://shopify.dev/docs/api/storefront/2025-04/interfaces/Trackable)

  interface

***

## SearchQuerySuggestion Implements

### Implements

* [Trackable](https://shopify.dev/docs/api/storefront/2025-04/interfaces/Trackable)