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


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

# Search​Query​Suggestion

object

A suggested search term returned by the [`predictiveSearch`](https://shopify.dev/docs/api/storefront/unstable/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/unstable/objects/SearchQuerySuggestion#field-SearchQuerySuggestion.fields.text) field provides the plain suggestion, while [`styledText`](https://shopify.dev/docs/api/storefront/unstable/objects/SearchQuerySuggestion#field-SearchQuerySuggestion.fields.styledText) includes HTML tags to highlight matching portions. Implements [`Trackable`](https://shopify.dev/docs/api/storefront/unstable/interfaces/Trackable) for analytics reporting on search traffic origins.

## Fields

* styled​Text

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

  non-null

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

* text

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

  non-null

  The text of the search query suggestion.

* tracking​Parameters

  [String](https://shopify.dev/docs/api/storefront/unstable/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/unstable/queries/search) or [predictiveSearch](https://shopify.dev/docs/api/storefront/unstable/queries/predictiveSearch) queries, otherwise returns null.

***

## Map

### Fields with this object

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

***

## Interfaces

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

  interface

***

## SearchQuerySuggestion Implements

### Implements

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