Plugin description

Experience a multilingual presentation of your Shopware shop with the innovative plugin Auto Translation Pro. Offer your international customers a first-class shopping experience by efficiently translating content and thus saving time and effort.

Our plugin is modular and allows you to seamlessly integrate additional functions via our plugin family. At the bottom of this page you will find detailed information on the various functions and configuration options as well as a helpful FAQ.

Plugin features and functions

  • Choice between two different translation services: DeepL and Google Translate
  • The source language and translation service can be freely set for each language
  • Simple translation of articles and variants
  • Translation also of additional fields
  • Fast translation at the touch of a button

Auto Translation Pro: General questions

To configure the plugin, please follow the steps below:

1. Upload the app in the administration under "Extensions/My Extensions".

2. Install and activate the app.

3. Go to the app configuration and add the translation service ID you need.

4. Create a Private Key for the translation service you want, we recommend DeepL. Note that you need the Developer Package to get a DeepL key.

If you use a Google Translate API Key, add this as well.

5. Check in the app configuration whether the private key is valid for the desired translation service.

6. Go to "Settings/Shop/Languages" and specify a source language and the desired translation API for the languages to be translated.

7. Once the language is configured, you can use it for translation.

If you would like to test the result before purchasing an API key, you can enter your text on the following pages and view the result:

DeepL Translation
Google Translator

The translation button is located under "Catalogue/Products/ProductX" next to the cancel button.

This error can occur if the database table was not created correctly during installation. This can be added with the following SQL commands.

Table 1
CREATE TABLE IF NOT EXISTS biloba_intl_translation_log (
id BINARY(16) NOT NULL,
initiator VARCHAR(255) NOT NULL,
entity_id BINARY(16) NOT NULL,
target_language_id BINARY(16) NOT NULL,
entity_type VARCHAR(255) NOT NULL,
type VARCHAR(255) NOT NULL,
status VARCHAR(255) NOT NULL,
context JSON NOT NULL,
created_at DATETIME(3) NOT NULL,
updated_at DATETIME(3) NULL,
PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

2. table
CREATE TABLE IF NOT EXISTS biloba_intl_translation_config (
id BINARY(16) NOT NULL,
source_language_id BINARY(16),
target_language_id BINARY(16) NOT NULL,
translation_api VARCHAR(255) NOT NULL,
created_at DATETIME(3) NOT NULL,
updated_at DATETIME(3) NULL,
PRIMARY KEY (id),
CONSTRAINT fk.biloba_intl_translation_config.target_language_id FOREIGN KEY (target_language_id)
REFERENCES language (id) ON DELETE CASCADE ON UPDATE CASCADE,
CONSTRAINT fk.biloba_intl_translation_config.source_language_id FOREIGN KEY (source_language_id)
REFERENCES language (id) ON DELETE CASCADE ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

There is a current issue with Shopware that may be similar to your problem. Please have your IT check the corresponding database table and change it to the correct ISO specification if necessary.

To the Shopware Issue

There is currently an error in Shopware that the wrong ISO code is stored in the database table for the text modules. This setting cannot be changed via the admin area, but must be entered directly in the snippet_set database table. Please make sure that the ISO code is also entered that is stored for the language in the settings under Language.

To make the translation button clickable, you have to create and activate the language in the backend as usual. This corresponds to the standard procedure in Shopware. Note, however, that the language only becomes visible in the frontend when you assign it to a sales channel. This way you can use the translation function without making the entire language publicly available.

Shopware uses the following inheritance sequence for the experience worlds:

  1. The main language inherits from the world of experience.
  2. The new language inherits from the main language.

If changes are now made to the layout area in the main language, the changes are adopted in the new language, as the new language inherits from the main language.

When the translation is started, the translatable elements from the main shop language are transferred to the new language, which are the text elements. The images are now taken from the original, the world of experience, as the new language no longer inherits from the main shop language, but now from the world of experience and the images are not "translatable".

Shopware 6 currently has an error that the sample images of the world of experience are not displayed, therefore no images are currently displayed after the translation.

The SEO URLs are generated by Shopware from the category title. This part is not translated by the extension.

These links are not recognised as links by our extension because the meta description cannot be edited with an HTML editor.

If these links are not to be translated, it is possible to create a new entry in the lexicon extension and enter this link in all required languages.

The translations of the extension are processed in the background via the Shopware Scheduler.

This stores the individual translations in the database table "messenger_messages" (version 6.5 & 6.6) or "enqueue" (version 6.4) with the help of the message queue. There you can also check whether entries are generated. As soon as a translation has been initiated, work can continue. The translation overview of the main extension shows whether articles have already been translated.

To ensure that the CLI Worker also runs when you are not logged into the admin area, it is recommended that you make the following adjustments recommended by Shopware (Set up CLI Worker).

The translations are processed via the Shopware message queue. To prevent an error on the part of Shopware from generating unnecessary costs at DeepL, we recommend activating cost control at DeepL.

These can be found in the DeepL account under "Consumption".


Auto Translation Pro Language Pack

This addon to the Auto Translation Pro plugin brings you more languages to translate into.
  • Choice between two different translation services: DeepL and Google Translate
  • We support all languages from Google Translate and DeepL
  • Easy installation
  • Other languages that can be translated into.

Auto Translation Pro Bulk

The Auto Translation Pro Bulk Plugin allows you to quickly translate articles and variants with a single click.
  • Translation is triggered once and runs through for the entire shop
  • Choice between two different translation services: DeepL and Google Translate
  • Translated articles and variants
  • Source language can be set in the plug-in options

Auto Translation Pro More areas

This addon for the Auto Translation Pro plugin allows you to start a translation in additional areas, e.g. categories, properties and more.
  • The app contains the areas: Properties, Categories, Manufacturers, Email Templates, Dynamic Product Groups, Worlds of Experience
  • Simple translation in other areas
  • Simple installation - no configuration necessary
  • Translation also of additional fields

Auto Translation Pro More areas Bulk

Expand the possibilities of your Auto Translation Pro Bulk plugin with this add-on and translate not only articles and variants, but also categories, content pages and more!

With just one click, all content in your selected area is automatically and effortlessly translated - quickly and efficiently.

  • The app contains the areas: Properties, Categories, Manufacturers, Email Templates, Dynamic Product Groups, Worlds of Experience
  • Translation also of additional fields
  • Simple mass translation in other areas
  • Simple installation - no configuration necessary

Auto Translation Pro Lexicon

With this add-on for the Auto Translation Pro plugin, you have full control over the words selected in translations. You simply specify the words and their corresponding translations, which are automatically used in each translation result.

Auto Translation Pro Lexicon: Frequently Asked Questions

Have you cleared the fields before translating manually? Manual translation only works if the fields are empty before translation or if you have everything translated in manual mode.