Reference product
A reference product is a product you attach to a prompt session — the AI assistant chat or the test panel — so that placeholders in the prompt are resolved against real values instead of being shown as {name}, {description} etc.
Why use one
Section titled “Why use one”Prompts contain placeholders. Without a reference product, the AI assistant only sees the template — useful for structural changes, but blind to what the prompt actually produces. With a reference product the chat sees the fully rendered system and user prompts, exactly as they would be sent to OpenAI when generating content for that product.
This makes refinement much sharper:
- “The description ends with ‘Buy now!’ even though the product is a B2B item” — the model can see why and propose a constraint.
- “The meta title is using the manufacturer name instead of the product name” — the model can see the rendered placeholder values and react.
How to attach one
Section titled “How to attach one”In the AI assistant chat panel or the Test tab:
- Click Pick reference product.
- Search by name or ID — the picker uses Shopware’s standard product search.
- Save.
The product is now used for prompt rendering in both the chat panel and the Test tab. It is not modified by anything you do — the chat is read-only against the product.
Reference product selection is per-session, not per-template. If you close the panel and reopen it, you need to pick the reference product again. This is intentional — the chat is a scratch space and shouldn’t persist arbitrary state.