Skip to content

Product snippets ​

Product snippets are private Q&A entries attached to a specific product in your catalog. Like regular snippets, they are never shown to the visitor; the AI uses them to answer, without citing them. The difference: they are scoped to a given product and only kick in when that product is in the conversation's context.

When to use them ​

Whenever you have information useful for answering questions about one specific product but don't want to publish it on the product page itself:

  • Sizing tips specific to that model ("Size up if you have wide feet").
  • Detailed care instructions you don't want to clutter the product page with.
  • Internal notes for the AI ("This model is end-of-life, don't push it").
  • Frequent questions specific to this product ("Is this product compatible with X?").

Product snippet vs. regular snippet vs. shared snippet?

If the information applies to a single product: product snippet. If it applies to a category or a set of products, write it once as a shared snippet targeting the right collection(s). If it applies to the whole brand, a general snippet is enough; the AI retrieves it when relevant.

Where to find it ​

  1. Open the dashboard and go to AI Agent → Train → Content → Catalog.
  2. Click the product you want to enrich.
  3. On the product page, click the "Product snippet" button (with a + icon) in the action bar.
  4. A side panel opens. The intro banner explains:

    "Snippets are custom knowledge you add to a product. The AI uses them to give more accurate answers, but they are never shown directly to shoppers."

Add, edit, delete ​

The panel shows the existing snippets for that product (newest on top), plus an "Add product snippet" button at the bottom to create a new one.

Each snippet has two fields:

  • Snippet title: a short, descriptive title (e.g. "Sizing tips").
  • Snippet description: the detailed description (the content the AI sees).

Both fields are required.

Editing: each card is editable inline in the list. If you make a change without saving, a Save + Undo button appear. Changes are persisted only when you hit Save.

Deletion: each saved card shows a delete button. A confirmation is required (with the snippet's title in the prompt).

No cap: you can add as many snippets as you like on a single product. No client-side maximum.

Shared snippets show up here too

If a shared snippet targets this product (directly or through one of its collections), it appears in a "Shared snippets" section at the bottom of the panel, read-only. Use "Open editor" to edit it on the Knowledge page; the change applies to every product it covers.

How the AI uses them ​

  • The agent only consults a product's snippets when that product is in the conversation's context (the visitor is on the product page, the AI is recommending it, or the visitor explicitly mentions it).
  • A product snippet is never cited or shown publicly, even if the AI uses it.
  • Product snippets stack with other knowledge (articles, global snippets, web pages); they don't replace them.

Don't confuse with ​

TypeScopeVisibility
Article (Knowledge)Whole storePublic + cited as source
Regular snippet (Knowledge)Whole storePrivate (AI only)
Product snippet (this page)Single productPrivate (AI only)
Product description (on the page)Single productPublic (visitor-facing)

If you're hesitating between a product description and a product snippet: anything visitors should see goes in the product description. Anything that should help the AI but stay invisible goes in a product snippet.

Released under the proprietary Humind license.