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.