From setup to apply: store the provider, create a job, collect and translate, maintain the glossary, review and approve - and know what an error message means.
Shopware 6.7, PHP 8.2 or newer and your own API key with the AI provider of your choice. Scheduled runs need the Shopware message consumer; manual runs work without it.
Cost: translation runs through your own account with OpenAI, Anthropic, Mistral or Google. You settle directly with the provider; nothing is routed through our servers.
Installation
Upload the ZIP in the admin under Extensions, install and activate it. Then enter the licence key; the check needs a shop domain configured in the sales channel.
All settings live in the admin module under the Plugin Suite. There is deliberately no config file.
Setting up the AI provider
Choose provider and model and store the API key. The connection test verifies both before the first run starts.
Available are OpenAI, Anthropic, Mistral and Google Gemini. Which model makes sense depends on volume and expectation - for catalogue text the faster models are usually enough.
Creating a job
First choose the sales channel. It deliberately comes first, because it determines which languages and which stock are available at all.
Then come scope and fields, followed by source and target languages as well as provider and model.
Recommendation: start with a small scope and one target language. The result tells you whether tone and glossary fit before you move the whole catalogue.
Collecting
Collecting reads the source texts and creates them as individual items. Only then is it clear how many texts actually need translating.
Texts unchanged since the last run are identified by a checksum and not sent again. That saves cost and keeps already reviewed translations stable.
Translating
On start the items go to the model in batches. A window shows the progress with percentage, processed out of total items and the remaining count.
Manual runs are processed in short segments in the admin and need no running message consumer. Scheduled runs still use the queue because they have to work without an open admin.
Pausing and resuming
A running job can be stopped with the cancel button in the progress window. The progress achieved so far is kept.
"Resume" continues the run later. This also applies to runs with the status Running, Ready or Translated that got stuck in an earlier version.
Glossary
In the glossary you store terms that should stay identical in every language or be translated in a particular way - brand names, product designations, technical terms.
The entries are passed to the model with every request. That keeps the language consistent across all runs, even when the model changes in between.
Review, approve, apply
Translated text first exists as a draft. You see source and translation side by side and can adjust individual texts before approving them.
Only applying writes the approved text into the Shopware translation tables. Until then nothing in the shop has changed.
Mind the order: only approved items are applied. Anything still in draft stays out.
Schedule
Recurring runs can be scheduled, weekly for newly added articles for example. These runs go through the message queue and need a configured consumer.
Understanding error messages
Since version 1.8.0 the messages are phrased in understandable language, in German and English. Instead of a technical raw response it states what went wrong and where to check.
Recognised and named are, among others: missing or rejected API key, rate limit reached, provider fault, provider unreachable, unreadable model response and a mismatching number of returned texts.
Unknown messages are normalised to a single line and truncated after 120 characters so the view does not scroll horizontally.
Troubleshooting
Run stays on "Running": for scheduled runs the message consumer is probably missing. "Resume" lets you finish the run without it.
API key is rejected: the connection test tells you whether key and model are enabled on your provider account.
Terms are translated wrongly: add them to the glossary and start the run again. Already approved text stays untouched.
Support
Questions and requests come straight to us - support is from the developer. You can also request a feature through the Plugin Suite in the admin.
All settings
Every setting of the plugin with its default value and explanation, in the same order as in the administration. The texts come straight from the plugin (version 1.9.3).
Translate
Choose scope and languages. The translation runs in the background and is applied directly.
Sales channelDefault: All sales channels
Limits the translation to one sales channel. For products, only products visible there are considered and the target languages are limited to the channel's languages. Without a selection all languages are available and the entire stock is considered.
ScopeDefault: Products
What is translated: products, categories, manufacturers, properties or property values. For manufacturers only the description is translated; the name stays unchanged as a proper name.
Source languageDefault: -
The language translated from. Its texts serve as the source for all target languages.
Target languagesDefault: none
One or more languages to translate into. The translations are saved directly under the respective language.
FieldsDefault: -
Which text fields of the chosen scope are translated, such as name, description or meta data. The choice depends on the scope.
Include variantsDefault: off
Translate variants with their own texts in addition to the main products. Increases the volume considerably.
Retranslate everythingDefault: off
By default only texts that changed since the last translation are processed. Enable this when everything should really be translated again after a model or tone change. This costs the full amount.
Additional instructionDefault: empty
Applies to this run only and takes precedence over the general rules. It also affects the preview so the result can be checked beforehand.
General
AI providerDefault: OpenAI
The service that translates the texts: OpenAI, Anthropic, Mistral or Google. The texts are sent to this provider. Test connection checks the access.
API keyDefault: empty
Access key for the chosen provider. Each provider has its own field; the key is kept when switching.
ModelDefault: depends on the provider, GPT-5.6 Luna for OpenAI
The model of the chosen provider. Without a selection the plugin uses the provider's default model.
Behaviour
Tone of the translation. Request bundling adapts automatically to the type of field.
ToneDefault: empty
Appended to the system prompt. Describes style and form of address, such as factual or informal.
Schedule
Translate automatically at a fixed interval. Only changed texts are processed.
Translate automaticallyDefault: off
Requires a running Shopware scheduled task. Manual runs remain possible at any time.
Interval (hours)Default: 24
How many hours pass between two automatic runs. Allowed range: 1 to 720.
Source languageDefault: -
The source language for the automatic runs.
Scopes in the scheduleDefault: none
Which scopes the automatic runs cover: products, categories, manufacturers, properties or property values.
Target languages in the scheduleDefault: none
All fields of the respective scope are processed.
Glossary
Binding terms. Brand names can be excluded from translation.
TermDefault: -
The term in the source language that should get a fixed translation.
TranslationDefault: -
The binding translation of the term. Stays locked if the term should not be translated.
LanguageDefault: All languages
Which target language the entry applies to, or all languages.
Do not translateDefault: off
For brand names and product lines that should stay identical in every language.
Availability
Directly from Stone & Water
Available now
Monthly9,99 €
Best valueYearly101,90 €15 % cheaper
All prices net, plus VAT.
Download the free Plugin Suite and upload it in the admin, no SSH needed. It installs and updates the plugin with one click. You buy the licence directly from us, with an invoice from us and support straight from the developer.
The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager in the backend, billing through your Shopware account. We will link it here as soon as it is available.