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

# Upload and manage your products

> Bring your product catalog into Peec to track AI Shopping visibility at the product level.

AI Shopping shows how individual products from your catalog appear across AI models, which products are being recommended, which competitors appear alongside them, and how performance changes over time. This guide walks you through everything you need to get your catalog connected so product-level tracking can begin.

You'll learn what data Peec AI needs, the three ways to import your catalog, and the exact CSV format required for uploads. Once your products are live on the **Products** page, AI Shopping will begin building visibility, ranking, and competitor insights as new AI runs are completed.

## How to add your product catalog

To track product-level visibility, Peec AI first needs a clear view of your catalog, what products exist, which brand they belong to, and how they're categorized.

Once that's in place, AI mentions can be attributed back to the correct products. There are **three** ways to import your catalog:

* **Shopify storefront:** paste your store's domain, and Peec AI pulls the catalog directly from your public `products.json` feed. This is the fastest path, and no file is required.
* **Peec CSV:** a flat file with one product per row, in our recommended format. Best for catalogs that aren't on Shopify.
* **Google Merchant Center feed:** your existing product data feed (CSV, TSV, or JSON). Useful when you already maintain one for Google Shopping.

All three land in the same place: products show up on the **Products** page, organized by the categories you provide, and become filterable across the Shopping overview.

1. Go to **Shopping → Products** in your sidebar.
2. Click **Add products** in the top right of the products table.
3. Pick **CSV** in the dialog, then drag and drop your file or click to browse.
4. Confirm the preview matches what you expect, then click **Upload**.

### CSV Format

A flat CSV with one row per product. The required columns are `title` and `brand`; everything else is optional but recommended.

| Column        | Required | Description                                                                         |
| :------------ | :------- | :---------------------------------------------------------------------------------- |
| `title`       | Yes      | Product name as you'd want it to appear (e.g. "Peec Logo Hoodie").                  |
| `brand`       | Yes      | Brand or vendor name. Used to group products and resolve to a canonical brand.      |
| `description` | No       | Free form product description.                                                      |
| `price`       | No       | Decimal string (e.g. `59.00`).                                                      |
| `currency`    | No       | ISO 4217 three letter code (e.g. `EUR`, `USD`).                                     |
| `link`        | No       | Product detail page URL.                                                            |
| `imageLink`   | No       | Primary product image URL.                                                          |
| `category`    | No       | Category path separated by `" > "`, e.g. `Apparel > Hoodies`. Any depth is allowed. |

<Info>
  You can [**download this example CSV**](https://app.peec.ai/Peec%20Shopping%20CSV%20Template.csv) to get started. Please make sure your file is UTF-8 encoded and uses commas as the field separator.
</Info>

Good `category` values matter: categories drive the breakdowns on the Shopping overview and the filters on the Products table. If your catalog already has a category tree, mirror it here.

Peec AI processes your catalog in the background. Products start appearing on the **Products** page within a few minutes, and per-product visibility, position, and competitor signals fill in as the next AI model runs complete.

### Google Merchant Center

Peec AI also accepts the standard Google Merchant Center product feed as is (CSV, TSV, or JSON). The full list of columns and accepted values is documented in the [**Google Merchant Center product data specification**](https://support.google.com/merchants/answer/7052112).

### Shopify Storefront

If your store runs on Shopify, you can paste your storefront domain (e.g. `your-store.myshopify.com` or your custom domain) in the **Shopify store** tab of the Add products dialog. Peec AI will fetch the full catalog from `products.json`, no file upload required.

## Managing your catalog

Switch between catalog and chat-discovered products, add them to your catalog over time, and remove products you don't want to track.

Your catalog isn't a one-time upload. This page covers how to work with it after the first import, and how to use AI Shopping without uploading anything at all.

### My catalog vs. All products

The **Products** page and the **Overview** have a source switch in the top right.

* **My catalog:** This will show only the products you uploaded.
* **All products:** This will show every product Peec AI sees in your tracked chats, both yours and your competitors'.

You don't need to upload a catalog to get value. Switch to **All products** to see the full competitive field from your chats right away. Uploading your catalog adds products the AI hasn't mentioned yet, along with the catalog price and your own category structure.

### Reviewing categories during upload

When you upload a catalog, Peec AI drafts a category tree from your data and shows it to you before anything goes live. Review it, adjust where needed, and confirm. Your products then land on the Products page, organized by those categories.

<Info>
  Categories drive the filters and breakdowns across AI Shopping, so it's worth getting this step right.
</Info>

<Info>
  If you upload a CSV while you already have products, the new rows are added to your existing catalog, and nothing gets replaced. To add a single product, a CSV with a single row is sufficient.
</Info>

### Removing products

Select one or more products on the **Products** page and delete them. They disappear from your catalog views. Products discovered in chats stay visible under **All products**.

<Info>
  After an upload, Peec AI doesn't start from zero. Your products are matched against chats from the last 30 days, so visibility, position, and competitor signals are populated based on history rather than starting from scratch.
</Info>
