Installation

Read Requirements first.

Install through the Administration

modernice sells the extension through the Shopware Store, therefore the usual route is Extensions → My extensions. Buy the extension for the account that your shop is connected to. Then install and activate it from the list. The Store lists it as AI Translation Suite — DeepL, ChatGPT, Claude, Gemini & Google. A zip file directly from modernice installs the same way, through Upload extension.

modernice All-in-One needs the same connection to a Shopware account for its in-app purchase.

Install with Composer

composer require modernice/sw-translate

bin/console plugin:refresh

bin/console plugin:install --activate NiceTranslate

bin/console cache:clear

TIP

To install and activate in two separate steps, for example inside a maintenance window, use bin/console plugin:install NiceTranslate. Activate the extension later with bin/console plugin:activate NiceTranslate.

Verify the installation

Open Catalogues → AI Translation. On a new installation the dashboard shows the Set up a translation provider banner, and Settings has four tabs: Providers, Automation, Advanced and Subscription.

To confirm that Shopware registered the console commands, execute this command:

bin/console nice-translate:providers

The output lists the seven translation providers and the configuration status of each one.

The two roles nice_translate.viewer and nice_translate.editor are in the Catalogues section, under Settings → Users & permissions → Roles. Permissions (ACL) describes what each role permits.

After these checks, continue with the Quick start.

Update the extension

Store installations: Shopware offers the update under Extensions → My extensions as soon as modernice publishes a new version.

Zip installations: upload the new zip file through Extensions → My extensions → Upload extension. Shopware then offers the update in the list.

Composer installations:

composer update modernice/sw-translate

bin/console plugin:update NiceTranslate

bin/console cache:clear

An update deletes no data. Let all active translation jobs finish before you update.

Uninstall the extension

Uninstall the extension through Extensions → My extensions. The context menu of the extension contains the Uninstall command. On the console, use this command:

bin/console plugin:uninstall NiceTranslate

In the Administration, Shopware asks whether it must keep user data. On the console, the same choice is the --keep-user-data option of Shopware. Without that option, Shopware deletes the data of the extension. Everything in the remainder of this section depends on that one choice.

Your translations always stay

The extension writes each translation as a native Shopware translation, into the translation tables of Shopware. These are the same rows that the Administration writes when you translate a field by hand. No uninstall path deletes them.

What "the data of the extension" means

If you do not keep the user data, the extension deletes its own records and nothing else:

Deleted	What you lose
Translation jobs and their per-record errors	The record of which runs occurred, what they cost and which items failed
Translation history	The previous value and the new value of each translated field, and with them the ability to revert
Glossary	All keep terms and replace terms, with their per-language translations. Export the CSV file first if you want to keep them.
Monthly usage records	The characters, tokens, requests and calculated cost per provider that the dashboard shows
Source and target fingerprints	The basis for the manual-edit protection and for skip-unchanged
Internal queue records	Durable batch manifests, completion markers and snapshots of finished-job events
All extension settings	Everything under the NiceTranslate.* configuration keys, including your stored provider API keys

If you keep the user data, all of these records stay in the database. If you install the extension again later, the module comes back with your jobs, history, glossary, usage and settings.

WARNING

The manual-edit protection and skip-unchanged compare against the stored fingerprints. After you delete those fingerprints, a new installation has nothing to compare against until it writes a field itself. A later run in Retranslate all fields mode would overwrite the existing translations, because it can no longer recognise them. If you plan to install the extension again, keep the user data.

Before you uninstall

• Export your glossary as a CSV file if you want to use it again.
• If you use modernice All-in-One and no longer need it, cancel the plan in the Shopware Store. The plan is a Shopware In-App Purchase and you manage it there. The extension has no cancel command of its own. See modernice All-in-One.
• Revert everything that you want to revert first. After the history is gone, the extension can no longer revert anything.

Next steps

• Quick start: connect a provider and start your first translation.
• Translation providers: API keys, models and routing per language.
• Settings reference: each setting on each tab.