# Store search: spelling, synonyms, results

> Tune your store search bar: spell correction, synonyms, highlighted matches, how many results show and groups of words that mean the same.

Source: https://docs.personacart.com/storefront/storefront-search

In short: {"Tune your store search bar: spell correction, synonyms, highlighted matches, how many results show and groups of words that mean the same."}

- When a visitor types in the search bar on your store, PersonaCart looks through your products and shows matches.
- **Store search** is where you decide how forgiving and how generous that search is: whether it fixes typos, whether it knows that "tee" and "t-shirt" mean the same thing, whether matching words are highlighted, and how many results appear.

Video: Store search (https://www.youtube.com/watch?v=LGtjlZSY6Ng)

This is a **Pro** feature. On a lower plan the page shows an upgrade prompt marked **PRO+**.

1. Open **Settings**, then the **Store search** tab.
2. Switch the search options you want and press **Save Settings**.
3. Under **Synonym groups**, press **Add group** and type words that mean the same.

## Where to find it

Settings → Store search. It is one of the tabs in the row under the **Settings** title. You need permission to change settings.

The page has two sections: **Search bar** (a card named **How search works**) and **Synonyms** (a card named **Synonym groups**).

## How search works

The card has two groups, **Finding products** and **Showing results**. Switches and the number are drafts: nothing changes on your store until you press **Save Settings**. **Discard** throws away your unsaved edits. If you try to leave with unsaved edits, a box asks whether to save or discard them.

| Setting | What it does | Default |
|---|---|---|
| **Spell correction** | Auto-corrects small typos so "snekers" still finds "sneakers". It is a good setting to leave on, because a typo should not mean an empty page. | On |
| **Synonym matching** | Matches related words: a visitor who searches "tee" also sees products matching "t-shirt". The words come from your synonym groups below. Helps when your word for a product differs from your buyer's. | Off |
| **Highlight matches** | Wraps the matching part of the product name or description in a highlighted style, so visitors see why a product matched. It does not change which products are returned. | On |
| **Max results per search** | The most products returned for one search, from 1 to 100. Type a number or use the **−** and **+** buttons. Lower numbers (around 10 to 20) feel quick and favour your best matches. Higher numbers suit catalogs people browse heavily after searching. | 10 |

After saving, a message says "Search settings saved". If it fails you see "Failed to save search settings" and your edits stay on screen.

## Synonym groups

A synonym group is a list of words that should find each other's products.

The card shows how many groups you have ("N of 200 groups"). The example on screen: sneakers = trainers = shoes.

  Under Synonym groups, press Add group.
  In Words that mean the same, type a word and press Enter or comma. Add 2 to 10 words.
  Press Save group. The group saves straight away; it does not wait for Save Settings.

- To change a group press **Edit**, then **Save group**.
- To remove one press **Delete**, then **Delete group** in the confirmation ("Searches for these words will no longer find each other's products").
- A group can have at most 10 words, and a word can belong to only one group.
- If something is wrong the page says so: "A group needs at least 2 words", "The same word is listed twice in this group", "One of these words is already in another group", or "You have reached the limit of 200 groups".

If **Synonym matching** is switched off, the card says "Synonym matching is switched off above, so these groups do not change search yet." You can still add and edit groups; they start working when you switch matching on and save.

## Good to know

- Search settings apply to your whole store. They change what the search bar returns for every visitor.
- Switching **Synonym matching** off keeps your groups. They simply stop affecting search.

:::note[When settings take effect]
The numbers and switches take effect only after **Save Settings**; synonym groups take effect as soon as each group is saved (and matching is on).
:::

## Questions
