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

# SKU Catalog

> Teach BounceBox your products so order lines are matched to real SKUs automatically.

When an order email is processed, BounceBox tries to match each line item to a product it knows. The SKU Catalog is that product list — active catalog SKUs are used to match each order line, so lines like "10x WDG-04 widget" come back with the right SKU attached instead of raw text. If your catalog has 200 or fewer active items, the full list is used for matching. Larger catalogs send the 200 items most similar to the email's text, so keep SKU codes, names, and aliases close to how customers and suppliers write them.

<Note>SKU matching works on every plan, including Starter. Imported items are used for matching as soon as you add them.</Note>

## Add a SKU

Fill in the add-SKU form:

| Field           | What it is                                                                                                                             |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| SKU             | Your product code, e.g. `WDG-04`. Must be unique — importing a SKU that already exists updates it.                                     |
| Name            | Human-readable product name.                                                                                                           |
| Aliases         | Alternative names customers and suppliers use, e.g. `widget`, `widg 4`. Aliases materially improve matching — add the messy spellings. |
| Unit price      | Price per unit.                                                                                                                        |
| Currency        | ISO code, e.g. `USD`.                                                                                                                  |
| Unit of measure | `pcs`, `box`, `kg`, ...                                                                                                                |

## Import in bulk

Import a CSV or XLSX file with the columns:

```text theme={null}
sku, name, aliases, unit_price, currency, uom
WDG-04, Widget type 4, "widget; widg 4", 9.90, USD, pcs
CBL-USB-2M, USB cable 2m, "usb cord", 4.50, USD, pcs
```

Rows are **upserted by SKU**: an existing SKU is updated in place, a new one is created. Re-importing your full catalog is safe.

## Correcting matches

Extraction gets you most of the way; your catalog knowledge finishes the job. When an order email has a wrong or missing match, open it in the [Inbox](/dashboard/inbox) and use the **SKU MATCHES — OVERRIDE ANYTHING** panel: each line shows its matched SKU and a `CONF {n}%` badge, and **Override** lets you pick the correct SKU. Overrides apply to that email's result.
