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

# Custom Catalogs

> Point ChatAds at your own product feed instead of (or alongside) Amazon

Amazon isn't the only catalog ChatAds can link to. If you have your own product feed, direct brand inventory, a private affiliate network, or a curated SKU list, ChatAds can use it as the catalog behind your widget's product links.

## What Is a Custom Catalog?

Any set of products you want product mentions to resolve to, instead of (or in addition to) Amazon. Common examples:

* **Your own product catalog** - e-commerce platforms, marketplaces, or retailers who want to surface their own SKUs
* **Direct brand inventory** - brands who want their products linked directly rather than through an affiliate marketplace
* **A private affiliate network** - custom link providers, CJ/Impact/Rakuten feeds, or first-party tracking
* **A curated product list** - a hand-picked set of products you trust for your readers

ChatAds handles the matching; you supply the catalog and the link format. Product mentions in chat replies then resolve to your inventory, with your tracking and your economics.

## Catalog Feed Format

Custom catalogs are uploaded as a flat feed - CSV or JSON, one row per SKU.

### Required Fields

| Field        | Notes                                                                                          |
| ------------ | ---------------------------------------------------------------------------------------------- |
| `title`      | Full product title. Used to match product mentions and shown as link context.                  |
| `url`        | Destination URL for the inserted link. Use whatever tracked link format your network requires. |
| `brand_name` | Brand name. Required for accurate matching.                                                    |

### Important but Optional

| Field           | Why it matters                                                                                |
| --------------- | --------------------------------------------------------------------------------------------- |
| `product_id`    | Unique product identifier, useful for your own reporting and dedup.                           |
| `image_url`     | Product image URL. Strongly recommended for any UI that renders product cards.                |
| `category_name` | Top-level category (e.g. "Kitchen"). Enables category targeting rules.                        |
| `category_path` | Full breadcrumb (e.g. "Home > Kitchen > Cookware"). Enables finer-grained category targeting. |
| `price`         | USD price. Needed for minimum-price quality filters.                                          |
| `stars`         | Star rating (e.g. `4.5`). Needed for minimum-rating filters.                                  |
| `reviews`       | Number of reviews. Needed for minimum-review-count filters.                                   |

Leaving an optional field blank simply skips the corresponding filter for that product.

### Example Row

```json theme={null}
{
  "product_id": "YOGA-MAT-001",
  "title": "Gaiam Essentials Premium Yoga Mat, 72\" x 24\" x 6mm",
  "url": "https://shop.example.com/p/YOGA-MAT-001?ref=chatads",
  "brand_name": "Gaiam",
  "image_url": "https://cdn.example.com/images/yoga-mat-001.jpg",
  "category_name": "Sports & Fitness",
  "category_path": "Sports & Fitness > Yoga > Mats",
  "price": 24.99,
  "stars": 4.4,
  "reviews": 18420
}
```

## Getting Started

Custom catalogs are set up with our team. Reach out to [team@getchatads.com](mailto:team@getchatads.com) for pricing and next steps.