AI Product Questions Manual.

How to generate typical questions and answers per product via AI and show them as a chat or FAQ on the product detail page.

System requirements

Shopware 6.7, an API key with one of the supported AI providers and a valid licence token. The plugin is part of the Stone & Water plugin suite.

Installation

The direct edition installs through an upload in the admin, no SSH access needed. After activation the menu entry appears under Extensions, Stone & Water - Plugin Suite.

Activating the licence

Until activation the admin shows a licence screen with an input field. The check is bound to the shop domain and works fail-closed: without a valid licence the widget is not rendered in the storefront. If the licence server is unreachable, a three day tolerance applies.

About the domain: The admin check and the storefront verify against the same host, so staging systems need their own licence entry.

Opening the settings

In the admin under Extensions, Stone & Water - Plugin Suite, AI Product Questions. That is where provider settings, bulk generation and single generation live.

Providers and models

Four providers are supported: OpenAI, Anthropic, Mistral and Google. For each one you store an API key and pick a model.

The model list is maintained over time. Older models stay at the end of the list marked as older so existing configurations keep working after an update. Mistral entries point at -latest aliases and therefore always resolve to the newest version.

Prompt instruction

The prompt instruction permanently shapes content and tone of the generated texts - concise and technical, focused on use cases, or in your shop's own voice.

Bulk generation

The bulk run generates questions, answers and pros and cons for many products in one go. Processing happens in batches whose size you control through the parallel processing setting. At the end you get a summary of generated, skipped and failed products.

Filters and scope

Active products only
Disabled products are skipped in the bulk run.
New products only
Products that already have texts are left out.
Overwrite
Existing texts are replaced instead of skipped.
Manufacturers
Restricts the run to selected manufacturers.
Limit
Caps how many products a single run processes.

Regenerating a single product

For targeted fixes there is a separate area with product search by name or article number. Several products can be picked one after another; they appear as chips below the search field and can be removed with an X. Products already picked are hidden from the search results.

Optionally you can add an instruction that applies to this run only - a content focus or a different tone, for example. It is passed in addition to the configured prompt instruction.

A deliberate exception: In single mode the selected product is always processed, even when „active products only" is switched on.

How it appears on the product page

The product detail page shows a chat area with a headline, an input field and a send button. The bundled default headline is „Ask me anything about this product", with a note below explaining that the digital advisor, like a human, can occasionally get things wrong.

If the AI has no basis for an answer, it says so clearly instead of guessing. On technical problems an error message asks the customer to try again later.

Pros and cons

Alongside questions and answers the plugin generates a list of pros and cons per product, rendered as its own block and marked as coming from the AI product advisor.

Where the texts are stored

The texts live in a dedicated table called staw_product_question_direct. The direct and store editions deliberately use separate tables so they can run side by side. When updating from an older version an existing old table is renamed automatically and the data is preserved.

Troubleshooting

The widget does not appear in the shop

Without a valid licence it is deliberately not rendered. Also check whether texts have been generated for that product at all.

Generation stops or reports errors

Usually a valid API key is missing or the chosen model is not enabled with the provider. The summary at the end of the run states the number of errors.

Products are being skipped

That is expected with „new products only" enabled, or when texts already exist and „overwrite" is off.

The licence is rejected in the admin

The check uses the host of the request. Opening the admin through a domain other than the licensed one makes it fail.

Support

We are happy to help with provider choice, prompt instructions or licensing. Get in touch via the contact page or write to info@stoneandwater.online.

Through the store or directly from us.

Two routes, the same feature set - pick whichever suits your setup.

Directly from Stone & Water

Available right now

Monthly9,99 €
Half-yearly49,99 €17 % cheaper
Best valueYearly89,99 €25 % cheaper

All prices net, plus VAT.

You buy the licence directly from us and get an invoice from us. Install by upload in the admin without SSH, updates through our licensing platform, support straight from the developer.

Ask us directly +49 2555 9997342

Shopware Store

In preparation

The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager, billing through your Shopware account. We will link it here as soon as it is live.

More trust on the PDP?

Back to Product Questions.

All features on the product page. We are happy to help with setup and integration.