> ## Documentation Index
> Fetch the complete documentation index at: https://docs.depict.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search

> Search analytics, synonyms, search content, the start view, and search configuration for the storefront search Depict serves.

The Search page manages the search experience Depict serves on your
storefront. Its tab set depends on which search generation the store runs:

| Tab | Available on | Purpose |
| - | - | - |
| **Overview** | Every store | Search analytics: KPIs, funnel, query tables |
| **Content** | Stores with Depict search | Non-product content in search results |
| **Synonyms** | Stores with Depict search on the previous engine | Vocabulary the engine should treat as equivalent |
| **Start View** | Stores with Depict search | What shoppers see when they open search before typing |
| **Configuration** | Stores on Depict's new search engine | Searchable fields, filter facets, sold-out visibility, search focus |
| **Exclusions** | Stores on Depict's new search engine | Tags and products hidden from search |
| **States** | Stores on Depict's new search engine | Suggested searches, blocked terms, tone of voice, storefront translations |
| **Boost & Bury** | Stores on Depict's new search engine | Search-specific ranking rules |

On Depict's new search engine the **Synonyms** tab is not shown, and the
page opens on **Configuration**.

## Limits and behavior

* The market and period selectors at the top scope the analytics. Period
  presets are 30, 7 or 1 days (default 30) plus a custom date range; change
  figures compare against the equally long period immediately before.
* The KPI tiles and search funnel on **Overview** require search performance
  reporting to be enabled for the store; the query tables show for every
  store.
* There is no per-query result curation: you cannot pin specific products to
  a specific search term. Result ranking follows automatic ranking plus the
  rules on the Boost & Bury page — and, on the new engine, the search-specific
  rules on this page's **Boost & Bury** tab.
* On Depict's new search engine, synonym sets have no effect: the engine
  matches related words on its own and does not use them.
* Query tables hide queries searched fewer than 3 times (they are still
  included in the CSV export), and **Total Searches** excludes queries under
  3 characters.
* Propagation: synonym changes take up to 30 minutes; Configuration,
  Exclusions and States changes reach the storefront within a few minutes;
  blocked-term changes can take up to an hour to reach autocomplete; Start
  View changes on the previous engine reach the store within about a minute.
* Caps: 20 excluded tags, 500 excluded products, 4 suggested searches per
  language, 200 blocked terms, and 6 pinned start-view products on the new
  engine.
* Exclusion removals (untagged or unlisted products) may take until the next
  catalog sync to reappear in search.
* The Query Performance export is capped at 20,000 queries; the
  least-searched queries are left out beyond that.

## Overview

For stores on the previous engine, the Overview combines:

| Element | Content |
| - | - |
| **Total Searches** | Searches in the period across all queries; queries under 3 characters excluded |
| **Zero-Result Rate** | Share of searches that returned no products |
| **Search CTR** | Clicks on search results divided by result impressions; tracked across all markets only |
| **Attributed Revenue** | Revenue from purchases where the shopper's last click came from a search result (approximate last-touch attribution, summed without currency conversion) |
| **Search funnel** | Searches → Result clicks → Add to carts → Orders, with step conversion; the result-clicks stage is hidden when a single market is selected because result clicks are tracked store-wide only |
| Zero-results insight | The period's zero-result share with an **Add synonyms** action |
| **Most common searches** | Top queries with counts and trends |
| **Most common searches without results** | Queries that returned nothing |
| **Export CSV** | Downloads the query data, including queries hidden from the tables |

Stores on the new search engine get a reporting dashboard as their Overview
instead: KPI tiles (searches, users, CTR, no-click rate, zero-results rate,
attributed revenue), metric charts (**Attributed Revenue**, **Search
Conversion Rate**, **Non-Search Conversion Rate**, **Total Searches**,
**Zero-Results Rate**, **No-Click Rate**, **Avg. Click Position**,
**Attributed AOV**, **Non-Search AOV**), a **Search Funnel**, **Search Entry
Points** (the page shoppers were on when they started searching), and a
**Query Performance** table with each query's full funnel — searches,
zero-results, clicks, CTR, carts, orders and attributed revenue. Charts
switch between **Daily** and **Hourly** views (hourly for ranges of 10 days
or less), can be filtered by country, and both metrics and query performance
export to CSV.

## Steering search results

Which products rank first for a query is decided by automatic ranking plus
your rules:

* On the previous engine, search follows the store-wide rules on the
  Boost & Bury page. To lift specific products in search, boost them (or a
  collection containing them) there.
* On the new search engine, the **Boost & Bury** tab on this page holds
  search-specific rules with the same boost and bury lists as the
  merchandising page. While no search rules exist, a banner states "No search
  rules — merchandising Boost & Bury applies" and search follows the
  merchandising rules. As soon as search rules exist, they replace the
  merchandising rules for search results ("Search rules set — overruling
  merchandising for search"); remove all of them to fall back.

## Synonyms

Synonym groups teach the previous engine your customers' vocabulary, per
language. Zero-result queries are the best source of candidates — the
**Add synonyms** action on the Overview's zero-results insight pre-fills the
form with the query.

1. In the page header, open the **Add** menu and choose **Add synonym**.
2. In the **Add synonyms** dialog, select one or more **Languages**.
3. Enter the words under **Synonyms**, pressing Enter after each.
4. Save.

Result: the group appears in the synonyms table; the toast states the change
may take up to 30 minutes to take effect.

If a new group shares words with existing groups, an **Overlapping synonyms
found** review shows how they will be combined; choose **Merge and save** or
**Save without merging**.

<Warning>
  Merging synonym groups cannot be undone — review the resulting groups before
  confirming.
</Warning>

Existing groups can be edited or deleted from the table.

## Content

The **Content** tab adds non-product content to search results, per
language — size guides, service pages, campaign landing pages. Each entry
has a **Title**, a **URI** and **Keywords**; the content appears when a
shopper's query matches a keyword. New entries are created from the page
header's **Add** menu with **Add content**.

## Start View

The **Start View** tab controls what shoppers see when they open search
before typing anything.

On the previous engine it holds two lists, **Pinned products** and **Pinned
collections**. The order in each list is the order shoppers see; drag to
reorder. Below each list, suggestions are drawn from the store's current
organic start view, so you can pin what is already showing. Changes save
automatically ("All changes saved") and reach the store within about a
minute. The **Preview** button shows the composition shoppers will get:
pinned items first, then the store's organic results.

<Note>
  The Start View needs a default market and language on the account; the tab
  says so and asks you to contact Depict support if they are missing.
</Note>

On the new search engine the tab instead holds a **Default product order**
setting (**Newest**, **Highest stock** or **Bestsellers**) for unpinned
products, and a **Pinned products** list of up to 6 products shown first.

## Configuration

Settings for stores on Depict's new search engine:

| Setting | What it controls |
| - | - |
| **Searchable fields** | Which catalog attributes are searched and how strongly each counts — fields at the top weigh more; add, remove and reorder. SKU and product ID are always searched with exact matching and cannot be turned off. |
| **Filter facets** | Which facets appear in the search filter panel and in what order. |
| **Show sold-out products** | When on, sold-out products appear ranked below in-stock products; when off, they are hidden. Tag exceptions keep specific products visible with no inventory (for coming-soon items and pre-orders); tags must match exactly, including capitalization. |
| **Search focus** | A slider between **Exact words** and **Meaning & concepts**: closer to exact only finds text present in the catalog and misses synonyms; closer to meaning handles synonyms but can miss exact names such as a brand. |

Saved changes reach the storefront within a few minutes.

## Exclusions

Two lists hide catalog items from search on the new engine:

* **Tags hidden from search** — products carrying any listed tag are hidden.
  Matching is exact and case-sensitive. Up to 20 tags.
* **Products hidden from search** — individually selected products. Up to
  500 products.

Newly excluded products disappear within a few minutes; products you remove
from either list may take until the next catalog sync to reappear.

## States

Per-language search states on the new engine:

| Section | What it controls |
| - | - |
| **Suggested searches before typing** | The search chips shoppers see when they open search, in order, per storefront language — up to 4. Saving marks them as yours so the nightly generator stops replacing them. |
| **Suggestion controls** | **Blocked terms** that must never appear in an AI-generated suggestion (case-insensitive, catches variants such as "jet-black" for "jet black"; up to 200), and an optional **Tone of voice** instruction for how suggestions are written. |
| **Translations** | Overrides for the storefront search texts per language — the search input placeholder and the filter labels. Empty fields use the default. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.