Product rules

Binding wording your AI must follow whenever it talks about a product — permitted claims, restrictions and mandatory disclaimers — matched to products by exact keys, never by guesswork.

What a product rule is

A rule is two things:

  1. Keys — the words a rule and a product have in common, usually an ingredient or a product name.
  2. The text — the sentence your AI reads word for word.

When a product turns up in an answer, every active rule sharing a key with it — plus any rule you have set to reach every product of the brand — is handed to the AI as binding wording that overrides everything else it found, overrides anything said earlier in the conversation, and overrides what the visitor asks for.

Rules exist for products only. They are not a place for general instructions to your AI — the agent's own instructions field covers those. Rules are for the cases where the wording is not yours to choose: regulated health claims, dosage warnings, legal restrictions.

How matching works

A rule reaches the AI in one of two ways, and you pick which one when you write it:

Products that share a key
default
The rule and a product in the answer have at least one key in common. Use it for anything said about a particular substance or product.
Every product of this brand
The rule reaches every product in the answer whatever keys it carries — including products with no keys at all — and carries no keys itself. Use it for wording that is true of your whole catalogue.

There is no AI in either match, no similarity scoring and no ranking: a key rule is an exact match on a tidied-up version of each key, and a brand-wide rule simply always applies.

A product's keys include its versions' keys. Keys come from the rule_keys your shop sends and from the product fields you chose to turn into keys — on the product and on any of its versions. So a rule keyed on an ingredient that only one flavor contains still reaches the product, because that flavor is part of it.
A brand-wide rule goes to your AI on every answer that mentions any product, so keep it short and keep it general — an "only the claims listed here may be made" sentence, a disclaimer that belongs on everything. Anything true of only one substance or one product belongs in a rule keyed to it.

Both sides of a key match are tidied identically:

  1. everything is lowercased;
  2. accents are stripped — Vitamin C, vitamín c and VITAMIN C are one key;
  3. punctuation and symbols become spaces;
  4. repeated spaces collapse and the ends are trimmed.

So " C-Vitamin, (Ascorbinsav)! " and "c vitamin ascorbinsav" are the same key.

Synonyms and translations are not matched for you. A rule keyed only on vitamin C will never reach a product whose only key is ascorbic acid. Put every spelling of the same thing — every language, every trade name, every abbreviation — into one rule, which is exactly what the keys field is for.Word order matters too: vitamin c and c vitamin are two different keys.

Two smaller consequences: a key made only of punctuation (, ()) saves happily but can never match anything, and a key-matched rule with no keys cannot be made live at all — if a rule genuinely is meant for everything, set it to every product of the brand rather than leaving its keys empty.

Always, or when relevant

Every rule carries one of two modes, and this is the only control over whether a rule can be filtered out.

Always
default
Passed to your AI every single time a matching product comes up. Never scored, never filtered, never dropped for relevance. Use it for conditions, restrictions, mandatory disclaimers and anything that must never be said.
When relevant
Passed only when it relates to what the visitor actually asked. Use it for situational guidance that only matters for some questions — a usage tip, a comparison — not for permitted-claims wording.

When relevant rules are scored against the visitor's question and kept only if they clear a relevance floor. If that scoring ever fails, the system fails in the safe direction: every when-relevant rule passes through, exactly as if it were an Always rule. Nothing is silently withheld.

Sentences your shop sends with a product always behave as Always rules for that product. A document import only ever writes Always rules, consolidated one rule per substance, so a list of permitted wording is in front of your AI every time it talks about that product — not only when a visitor's question happens to match it. That same pattern — Always, one rule per substance — is the one to follow for permitted claims you write by hand, with Copilot or over MCP; When relevant stays yours to choose for everything else.

Writing a rule by hand

Press Add rule on the Rules tab.

Which products it applies to
default
Products that share a key, or Every product of this brand. Choosing every product hides the Keys field — a brand-wide rule carries none.
Keys
required
Press Enter after each. Up to 100 keys, each up to 200 characters. Required unless the rule applies to every product, in which case it is not shown at all.
The rule
required
Up to 5,000 characters. Write it exactly as it must be followed — your AI reads this word for word.
Note for your team
Up to 2,000 characters. Where the rule comes from, who signed it off. Never sent to the AI.
When it applies
Always, or when relevant.
Status
Live or Draft. A rule you type yourself starts Live — a person wrote it, so there is nobody left to review it.

Importing rules from a document

If your rules already exist as a document — a regulator's list of permitted claims, an internal wording guide — press Import from document and let the AI turn it into draft rules. Any shape of document works: a claims table, a policy, a contract.

Say what the document is

What is this document?
Let the AI decide (the default), A list of permitted claims — nothing outside it may be said, Restrictions, conditions and warnings, or Something else.

::

This is a hint, never a switch that changes how the file is read. Left on the default, the AI judges from the text itself — and the finished screen tells you what it decided.

Pick the model

The AI model dropdown starts on your organisation's everyday model. The longer or more intricate the document, the more it is worth choosing a stronger one: a dense claims table with footnotes and conditions deserves a top model, a short plain list is fine on a cheaper one.

The size limit follows your choice and is shown right under it — "Gemini 3.1 Flash Lite: up to about 957 pages (670,574 tokens) in one import." If your document is longer than that, split it yourself and import each piece.

Upload it

PDF, Word or plain text, up to 30 MB.

A scanned PDF holds pictures of text, not text. It cannot be read, and you will be told so before anything is charged.

Add instructions (optional)

Anything the AI should know about this particular document — how it is laid out, which parts to ignore, what the keys should be. For example: "The first column is the ingredient; ignore the preamble."

Let it run

The window reports each stage: Mapping the document, then Reading N sections — M done, then Merging and writing drafts, with a running count of the statements found and how many of them the check added.

You can close it — the import keeps running, and coming back to the Rules tab reopens the progress window on the run.

Review the drafts

The finished screen says what it covered: "N draft rules created", "N statements found in the document, M of them added by the check", and how it read the file — "Read as a list of permitted claims · language HU". Every rule arrives as a draft; nothing is live until you approve it. ::

How the document is read

The AI does not blindly chunk your file. It first maps the whole document and divides it into sections along its own content, reads every section separately, and then checks each section again for anything it missed, merged into one sentence, or worded wrongly — that second pass is where the "added by the check" number comes from.

The whole document still has to fit your model's window once, for that first mapping pass. That is what the size limit measures.

What an import produces

Everything an import writes is an Always rule. Imports no longer produce "when relevant" rules at all: a list of permitted wording has to be in front of your AI every time it talks about the product, not only when the visitor's question happens to match it. The mode is still yours to choose on rules you write by hand, with Copilot or over MCP.
  • One rule per thing, not one per claim. Every permitted statement about a substance, product or topic is consolidated into a single rule. It opens with the exclusivity sentence — "only the following statements may be made about X, and nothing beyond them" — then lists each statement verbatim and numbered, and states a condition they all share once at the end. A substance with eighteen authorised claims becomes one rule, not eighteen.
  • Conditions travel with their claims. Restrictions, conditions and prohibitions about the same thing are folded into its rule; ones that stand on their own become Always rules of their own.
  • A rule the document states for everything it covers is written once, as a single rule set to every product of the brand — so it also reaches products the document never names, and products carrying no keys. If the document really governs only part of your catalogue, switch that draft to "products that share a key" while you review it and give it the keys it should have.
  • Keys carry synonyms automatically. The import adds the other names for the same thing — common names, abbreviations, chemical forms and salts, spelling variants, and the English name when the document is not in English. A Hungarian rule keyed on Folát also carries Folsav, B9-vitamin and Metilfolát. Rules you type yourself are still yours to spell out, as the warning above says.
  • Footnotes that limit a claim — licensed to one company, valid only until a date — go into the note for your team, never into the wording your AI reads.

When an import does not finish cleanly

Two things can happen, and neither loses what was already written:

  • Some sections could not be read. The import still finishes, and an amber warning names the parts that were missed. Everything else is kept; import the file again to get the rest.
  • The run was interrupted — a deploy or a crash stopped it halfway. The window reads "The import did not finish" and offers Resume, which continues from the sections that never finished and never redoes what was already written. The Rules tab reopens that window on its own when you come back to it.

The approval gate

Nothing an AI produced is ever live until a person approves it. Rules written by a document import, and rules written by Copilot or an assistant, all arrive as drafts. A draft is stored and visible in the dashboard, but it is never read when an answer is written — on any channel.

The Review drafts screen (also reachable from the amber banner above the rules table) is where you go through them:

  • Pick an imported document on the left to review just its drafts, or review every draft at once.
  • Each row shows its keys, its text, its team note, and a mode dropdown you can change on the spot.
  • Edit, Approve or Discard one at a time, or select several and approve or discard them together.
  • Discarding shows an Undo in the toast — it is reversible for a moment.

A rule matched by keys cannot be approved without at least one key; approving a batch that contains such rules fails and names them. Rules set to every product of the brand are exempt — carrying no keys is the point of them.

Re-importing the same document

Import an updated version of a file you imported before and the review screen compares the two automatically:

  • New — a rule with keys that had none before.
  • Changed — same keys, different wording, shown with the old text struck through. Approving it deletes the wording it replaces, so you can never end up with both live.
  • Rules that were identical are dropped silently — there is nothing for a person to look at.
A re-import never deletes anything. It only ever offers you drafts to approve, so your existing rules are safe no matter how the comparison turns out. Two rules are matched by their keys, and the AI writes its list of alternative names slightly differently each time it reads a document — so a rule you already approved can easily show up as New rather than Changed, even when the document has not changed at all. That is harmless when the worst case is an extra draft to approve; it would not be harmless if the same comparison were allowed to delete your work.If a document genuinely drops a claim and you want the old rule gone, delete it yourself from the rules table — search for it, tick it, and use the bulk delete.

Where rules are applied

Every answer a visitor can see:

  • the chat widget
  • email
  • Facebook and Instagram
  • AI reply suggestions your agents see in the inbox
  • phone calls

They are deliberately not applied to things that never answer a visitor: the inbox panel that shows an agent what the knowledge holds, agent-monitoring checks, and AI social-post generation.

What happens if there are too many rules

The whole block of rules for one answer is capped at 100,000 characters. At the cap, nothing is ever trimmed — instead the lowest-ranked products leave the answer whole, taking their passages, their product cards and their rules with them, until the rest fit in full.

The same applies if the rules cannot be read at all: the products leave the answer. Your AI is never allowed to describe a product while missing some of its rules.

You will not meet this ceiling in normal use — a product's own usage is shown on its page in the catalogue.

Managing rules in bulk

The rules table supports searching the rule text and filtering by status, by mode and by origin (written by hand, from a document, or by an assistant). Select several rows to approve, set to Always, set to When relevant, or delete them together.

A rule that applies to every product of the brand shows an Every product badge where its key chips would be — on the rules table and on the review screen alike.

Copilot can also draft rules for you — see Copilot and MCP. It asks for confirmation before it writes anything, and everything it creates is a draft.