The product catalogue

Every product your AI can talk about, its versions, the keys each one carries, the rules that apply to it, and what the AI actually reads for it.

A product and its versions

A product is a base product with one or more versions underneath it. A version is one thing a customer can actually buy — a flavor, a size, a color, or a combination of them — and it carries its own price, its own stock status, its own link and its own id.

A product you sell in only one form still has one version; you never have to think about it. A protein powder in eight flavors and three sizes is one product with up to twenty-four versions, instead of twenty-four unrelated products.

This is why the AI can say "we have Gold Whey in eight flavors" instead of listing the same product eight times as if they were different products. Identity and rules live on the product; price, stock and the buy link live on the version.

The products table

Brand → (your brand) → Products → Products lists everything the brand's sources have delivered — one row per base product, not per version.

ColumnWhat it shows
TitleClick it to open the product. The source that delivered it is printed underneath.
CategoryThe product's category. A dash means the source sent none.
VersionsHow many versions it has. Click it to fold them open underneath the row.
PriceThe price across every version — a single figure when they all cost the same, a range like 29.90 – 79.90 EUR when they don't.
PriorityThe order number your shop sent for this product. Higher comes first; the default is 0.
ActiveWhether the product may be recommended.

Search matches the product title. You can filter by source and by active or disabled.

The versions list

Clicking the Versions button folds that product's versions open under its row, in the order your shop sent them. Only one product is open at a time — opening another folds the previous one.

Each line shows the version's options (for example Pistachio · 1 kg), its own price, an In stock or Out of stock badge when your shop said which, and the version's id.

A product whose versions have not arrived yet shows "This product has no versions yet. It gets them on the next refresh of its source." That only happens in the window between a product being created and its source being read again.
There is no "add product" button, and there never will be — the catalogue is filled by sources only. Deleting a product here removes it until the next refresh, when the source delivers it again.

Opening a product

Clicking a title opens everything that product carries into an answer.

The three tiles

  • Keys — how many keys it carries.
  • Live rules — how many active rules match it, with drafts counted separately beside it.
  • Rule text used — how much of the 100,000-character ceiling this product's rules take up, as a percentage with a bar. The bar turns amber at 60% and red at 100%.

Keys, and where each one came from

Keys are grouped by origin, and each group says which:

  • Sent by your shop as a rule key — it arrived in the product's rule_keys list.
  • Read from the field "…" — it is a value of a product field your source turns into keys.
A product with no keys shows an amber notice: "This product has no keys, so only rules set to every product of the brand can apply to it." If you expected keyed rules on it, either your shop is not sending rule_keys, or the source is not configured to turn the right field into keys.

Versions

Every version of the product, with its options, its price, and an In stock or Out of stock badge. This is the same list the table folds open, shown in full.

Search terms

Extra words your shop sent so that the search can find this product — nicknames, an old product name, a common misspelling, the word customers actually use.

Search terms are only used to find the product. The AI never sees them, and product rules never match on them, so you cannot use one to smuggle wording into an answer.

What the AI reads for this product

A panel you fold open to see exactly what this product looks like to the AI. It is the fastest way to answer "why did it say that?" without guessing.

  • The product sheet — what goes into an answer whenever the search finds this product, with current prices and stock filled in at the moment you open the panel.
  • The search card — what the search matches a question against, shown in the pieces it is split into. A product that has not been indexed yet says so, and the next refresh of its source indexes it.
  • Overview pages that list this product — the catalogue pages this product appears on. A category page lists its first 25 products by priority, so a product further down the order legitimately appears on none.

Rules that match this product

Every live rule that reaches this product — the ones sharing a key with it, and the ones set to every product of the brand — each showing whether it applies Always or When relevant, and which keys matched. A brand-wide rule shows an Every product badge instead of key chips. Drafts are hidden behind a toggle and clearly marked "Draft — not live", because a draft is never sent to the AI.

Sentences sent with the product

If your shop sends rules with a product, they appear here. These always go to the AI whenever the product is mentioned — they behave exactly like an Always rule that belongs to this one product.

Product details and attributes

Folded away by default: price, availability, priority, category, brand, product id, the full description, and every custom field your shop sent. Fields that the source turns into keys are badged key field.

The size line

At the bottom, always visible:

"{used} of 100,000 characters. Live rules and the sentences your shop sent, counted together."

If one product's rules ever went over that ceiling, the product would be left out of the answer completely rather than described with only some of its rules. That is deliberate: a half-ruled product is worse than no product.

The figure counts live rules and shop-sent sentences only — drafts are excluded, because they are never sent.

Enabling, disabling and deleting

Each row offers Details, Enable or Disable, and Delete. You can tick several rows and delete them together.

  • Disabling a product takes it out of answers and product cards but keeps it in the catalogue. A refresh will not switch it back on — a product you switched off by hand stays off.
  • Deleting a product removes it, all of its versions, and what the AI learned about it, and rewrites the brand's overview pages so the deleted product stops being listed. It comes back on the next refresh if the source still has it.
Versions are never enabled, disabled or deleted one by one. They belong to their product and follow it — the only way a version changes is through the source that delivers it.