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

# Products

> Which products ChatGPT shows as shopping cards for your buyers' questions, which of your own it never shows, and where it quotes the wrong price.

Products answers: when a buyer asks ChatGPT what to buy, which products does it put in front of them, and are yours among them? It reads the product cards in the answers your project already collects. Nothing extra is asked, and nothing is changed anywhere.

## Before you start

Product cards appear for buying questions, such as "best running shoes under \$100". If your prompts are all research questions, add a few buying ones in [Prompts](https://docs.citino.ai/guides/screens/prompts.md).

Only ChatGPT shows product cards we can read. The screen says which engines in your scope report them and which don’t.

## What is on it, top to bottom

### The sentence

The headline puts two numbers side by side: how often ChatGPT **named your brand** in its shopping answers, and how often it **showed your products** there, for example “ChatGPT named Bella Vita in 50% of shopping answers and showed its products in 12%.” A large gap means ChatGPT knows the brand but puts other products in its cards. Hover a number for its `±` band and how many shopping answers it rests on; with none yet, it shows “—”.

Under it, how many products ChatGPT showed, in how many shopping answers, and how many of them are yours; then how many of ChatGPT’s answers showed products at all, and which engines report cards.

A **shopping answer** is an answer with at least one product card. Visibility on this screen is a share of shopping answers, not of every answer, so a project with mostly research questions does not show every product near zero.

### Shown

Every product ChatGPT showed, most visible first, as a card the way a shopping page shows one:

* **The picture**, on a soft square. A product with no picture, or one whose picture fails to load, shows its first letter instead.
* **The title** as ChatGPT showed it, then the latest price a card quoted (in the card’s own currency) and the store its cards linked to most, with how many others.
* **Shown in**: the share of shopping answers that showed it, with its `n` beneath. Hover the number for its `±` band. Beside it, the change from the previous window, or **within noise** when the change is smaller than the band.
* **Yours** marks one of your own products, and its number is in your accent colour.

Hover or tab to a card to see how often it was the first card (its **win rate**) and its average position. Filter by **All**, **Yours** or **Others**; **Show more** loads the next products. Open a card to see [Product detail](https://docs.citino.ai/guides/screens/product-detail.md).

A product is **yours** when, in this order:

1. its card links to the same page as one of your catalog products;
2. its title is the same as a catalog product’s;
3. most of a catalog product’s title words appear in its title, ignoring your brand name, sizes like “100ml” and generic words like “for men” or “eau de parfum”. This is how a retailer’s “Bella Vita Luxury CEO Man Eau De Parfum for Men 100ml” on Amazon finds your “CEO MAN Perfume - 100ml”. When two of your products fit equally well, neither is chosen and the next rule decides;
4. its title or its seller names your brand (or one of its other names), or its card links to your own site. These products are yours but belong to no catalog product.

Only the first three count a catalog product as shown. Matching is word overlap, so a re-worded title that shares too few words is missed, and a competitor whose title repeats your product’s distinctive words could be counted. With no catalog connected, rule 4 alone decides.

### Your catalog

Appears once a catalog is connected, as the same cards for your own products. One line counts how many of your products appeared, how many never did, and how many are quoted at a price your catalog doesn’t have. Each card shows your price and how often it was shown. A product ChatGPT never showed is greyed, marked **Not shown by ChatGPT**. When ChatGPT quotes a price more than 1% off yours in the same currency, the card says both: “ChatGPT says $249.00 · you sell at $229.00”. With GA4 connected, each card ends with the AI-referred revenue, sessions and conversions of its page.

**Add to Gaps** turns a product that is never shown, or quoted at a different price, into a [Gaps](https://docs.citino.ai/guides/screens/gaps.md) work item. Filter by **All**, **Not shown** or **Price differs**.

## Connecting a catalog

Choose one of three ways. Choosing one shows the one field it needs.

* **Shopify store**: your store’s domain. Citino reads the store’s public product list once a day as CitinoBot, if your `robots.txt` allows it. Nothing to install.
* **Merchant feed**: the product feed URL you give Google Merchant Center, read once a day.
* **CSV file**: drop a sheet with `id`, `title` and `url` columns, and `price` with a `currency` (or a price like `229.00 USD`). Add an `image` column (or `image_link`, `image_url`, `photo`) with each product's photo address and the cards show your photos; Citino copies each one to its own storage once. It is read in your browser, you see how many products it holds, and it uploads in batches with a progress line. Upload again to replace it.

Up to 5,000 products are kept. Owners, admins and editors can connect, sync and disconnect.

## States

* **Loading**: placeholder cards in the shape of the page.
* **No engine in scope shows product cards**: names the engines; there is nothing to change.
* **No answers yet**: the scope needs one full run first.
* **No shopping answers**: answers exist, and none showed product cards. Add buying questions in Prompts.
* **Reading your catalog**: a sync is running; results in a minute or two.
* **Last sync failed**: the reason, and what to do instead (a feed URL or a CSV). The last good catalog stays in use.
* **Truncated**: the catalog has more than 5,000 products and the first 5,000 were kept.
* **Connect GA4**: one line above your catalog links to [Integrations](https://docs.citino.ai/guides/account/integrations.md); every card still shows, without its revenue line.

## Related

> [card] [Product detail](https://docs.citino.ai/guides/screens/product-detail.md)
>
> One product: its trend, prompts and prices.

> [card] [Gaps](https://docs.citino.ai/guides/screens/gaps.md)
>
> Where a product fix becomes a work item.


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