The product catalog
Every product your AI can talk about, its versions, the keys each one carries, the claims and instructions 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.
The products table
Brand → (your brand) → Products → Products lists everything the brand's sources have delivered — one row per base product, not per version. It is described as Everything Yaplet can talk about, one row per product. Open a product to see what your shop sent for it. Until a source has delivered something, the page says No products yet: Products appear here after a source's first read or push. Add a source on the Sources tab.
| Column | What it shows |
|---|---|
| Product | The product's picture and title — click it to open the product. Underneath are its product id and the source that delivered it. |
| Price | What a visitor pays across every version, sale prices included — a single figure when they all cost the same, a range like 29.90 – 79.90 EUR when they don't. |
| Stock | In stock, Out of stock, or for example 2 of 3 in stock when only some versions are. A dash means your shop sent no stock information. |
| Versions | How many versions it has. Click it to fold them open underneath the row. A product sold in one form only shows a dash — there is nothing to list. |
| Category | The product's category. A dash means the source sent none. |
| Priority | Your shop's own order for its products. Higher comes first. Products with a priority lead every list the AI shows, in priority order, and the AI presents that order as your most popular products. Hidden at first — switch it on from the table's Columns menu. |
| Popularity | A number from your shop that orders the products without a priority, after the ones that have one. Only the order matters — the AI never sees the number itself. Hidden at first, like Priority. |
| Rating | The average star rating, with the number of reviews in brackets — ★ 4.8 (312). |
| Status | Active, Disabled or Paused by source — see below. |
Search matches the product title. You can filter by source (All sources by default) and by status — Active and disabled by default, Active only or Disabled only; the last one also lists products paused by their source.
Values worked out from the versions
Your shop can send priority, popularity and rating on the product, on each of its versions, or on both. When the product has no value of its own, the table shows the value your AI actually ranks the product by, worked out from its versions, in gray italics. Hover it to see how it was worked out:
- Priority — its best version's priority.
- Popularity — its versions' figures added up.
- Rating — its versions' ratings averaged, weighted by their number of reviews.
A dash means neither the product nor any of its versions carries that value.
Status
- Active — the product may be recommended.
- Disabled — someone switched it off here. It stays off until a person switches it back on; a refresh never does.
- Paused by source — its source could not be refreshed several times in a row and is set to hide its products when that happens (see Product sources). It comes back by itself after the next successful refresh.
The versions list
Clicking the Versions button folds a small table open under the row, one line per version, in the order your shop sent them. Only one product is open at a time — opening another folds the previous one.
| Column | What it shows |
|---|---|
| (options) | The version's option values, such as Pistachio · 1 kg. The column is headed by your shop's own option names — Flavor · Size. |
| Price | What the version costs. When it is on sale, the regular price is shown struck through beside it. |
| Stock | In stock or Out of stock, when your shop said which. |
| Priority, Popularity, Rating | The version's own values — not the product's. |
Click any line to open that version's window — see Opening a version below.
Opening a product
Click a product's title (or Details in its ⋯ menu) to open everything that product carries into an answer. The top of the window shows its picture, its status, the source it came from, and a View in shop link to its page in your shop. The rest is split into tabs: Overview, Versions, Claims & instructions, Attributes and What the AI reads.
Overview
- The facts your shop sent — price, stock (In stock, Out of stock, or for example 3 of 8 versions in stock), category, brand and product id. Only the ones your shop actually sent are listed.
- Ranking values — Priority, Popularity, Rating (with the number of reviews) and Added (the day your shop added the product). The question mark beside each one explains what your AI does with it. When the product has no value of its own, the one worked out from its versions is shown, with a gray line underneath saying so — Its best version's, Its versions added up, Average of its versions or Its earliest version's. Not sent means neither the product nor any version carries it.
- 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.
- Description — the first few lines, with Show all for the rest.
Versions
Shown for a product with several versions. It is the same table the products list folds open, with a line on top: every version has its own price, stock and ranking values. Click a version to open its window on top of the product window; closing it brings you back here.
Claims & instructions
What your AI is bound by whenever it mentions this product. The tab's label counts the switched-on claims and instructions and the sentences your shop sent — Claims & instructions (3).
Claim and instruction text used sits at the top: how much of the 100,000-character ceiling this product takes up, as a figure and a bar. The bar turns amber at 60% and red at 100%. It counts the claims and instructions that are on and the sentences your shop sent — switched-off ones are excluded, because they are never sent.
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_keyslist. - Read from the field "…" — it is a value of a product field your source turns into keys.
rule_keys, or the source is not configured to turn the right field into keys.Claims
The switched-on claims that reach this product through a shared key — what your AI may say it does, is good for or is suitable for. When none does, the list says "No claim applies to this product." While claims are on for the brand, it adds why that matters: "It still appears in answers, but the AI won't say what it does or recommend it for a goal."
Instructions
The switched-on instructions that reach this product — the ones sharing a key with it, and the ones set to every product of the brand, which show an Every product badge instead of key chips.
If your shop sends rules with the product, they appear underneath, under Sent with the product. They are instructions too: your AI gets them whenever the product is mentioned.
Switched-off claims and instructions
Claims and instructions that would reach this product but are switched off sit behind a Show N that are switched off button. Each is marked Off and Claim or Instruction. Your AI never sees them until someone switches them on.
Attributes
Shown when your shop sent custom fields with the product itself. Each field is on its own line: a list reads as one line, and a table-shaped field — a nutrition table, say — is shown as a real table. Fields that the source turns into keys are badged key field. Each version's own fields are in its version window.
What the AI reads
Exactly what this product looks like to the AI — 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 tab.
- 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 catalog 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. Phone calls use these pages; chat answers do not.
Opening a version
Click a line in any versions table — under a product's row, or on the product window's Versions tab. The version window shows everything your shop sent for that one version:
- its option values, its stock, its price (the regular price struck through when it is on sale) and a link to its page in your shop;
- This version's own values — priority, popularity, rating and the day it was added. The question mark beside each one explains what your AI does with a version's value, which is not the same as with a product's: when it names just one version, it picks the in-stock version with the highest priority, and a version's popularity decides which flavors or sizes it may call the most popular ones;
- the version's own search terms, attributes and rule keys.
Enabling, disabling and deleting
Each row's ⋯ menu (More actions) offers Details, Enable or Disable, and Delete. Tick several rows to enable, disable or delete them together.
- Disabling a product takes it out of answers and product cards but keeps it in the catalog. A refresh will not switch it back on — a product you switched off by hand stays off.
- Enabling and disabling ask no confirmation, and the ticked rows stay ticked, so undoing is one click away.
- Deleting asks first, then removes the product, 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.