1. Introduction
The Mass Translate by ChatGPT module in Magento 2 enables automatic translation of product descriptions, allowing you to quickly adapt your offer to new markets. Translated content is saved in the selected store view.
Module installation
To install the module, simply:
- Install the module: - Add the composer repository to the configuration by running
composer config repositories.masstranslatebychatgpt vcs https://github.com/kowalco/magento-2-mass-product-translate-by-chatgpt
Add an access token for the private repositorycomposer config --global --auth github-oauth.github.com <YOUR_TOKEN>
Install the composer module by runningcomposer require kowal/module-masstranslatebychatgpt
Enable the module by runningphp bin/magento module:enable Kowal_MassTranslateByChatGPT
- Run the commands:
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush bin/magento indexer:reindex sales_order_grid
2. Module configuration
To configure the module, go to:
Admin Panel Magento 2 → Stores → Configuration → KOWAL → Mass Translate by ChatGPT - Settings
or
Admin Panel Magento 2 → KOWAL.co → Mass Translate by ChatGPT - Settings
2.1. General settings
- Enable Module – Enables or disables the module.
- OpenAI API Key – API key for communication with ChatGPT, which you can generate here
- Max Translations per Day – Maximum number of products to translate per day.
Defines the limit of products that can be translated within one day. The limit depends on the size of product descriptions.
2.2. Translation settings
- Source Language (source language) – Select the language and Store ID.
Select the language from which the content will be translated.
Important! Selecting a language also means selecting the Store ID, meaning the store view from which the original texts will be retrieved.
- Target Language (target language) – Select the target language and Store View.
Select the language into which the products should be translated.
Important! Defining the target language also means selecting the store view where the translated content will be saved.
- AI Model Instructions – Instructions for ChatGPT.
You can customize the commands for ChatGPT.
Example: Translate the specified attributes from Polish to English.
- AI Model – Select the AI model.
- Attributes to Translate – List of attributes to translate.
Specify which product fields should be translated, for example:
Description (product description)
Image Label (image label)
Instructions (usage instructions)
Compatibility (compatibility data)
3. Translating products
- Go to Catalog -> Products.
- Select the products for translation by checking the checkbox next to them
- Select the bulk translation option.
Click the actions menu and choose the translation-related command.
The system will start processing, and the products will be sent to OpenAI.
- You will be automatically redirected to the Tasks section to track progress.
4. Monitoring translation tasks (Translations)
To check task status:
- Go to the Translations section.
- There you will find a list of all requested translations with details:.
Status – completed (completed) or error (error).
Products – how many products have been translated.
ChatGPT Model – which AI model was used.
Tokens Input/Output – the number of tokens processed in the request.
Instruction – the AI command used.
Language From / Language To – source and target language.
Task statuses
completed – translation completed successfully.
error – translation error.
If the translation failed, check:
Whether the entered OpenAI API key is correct.
Whether the selected AI model is supported.
Whether the daily translation limit has not been exceeded.
5. Reviewing and saving translated content (Product Tasks)
- Go to the Product Tasks section.
- There you will find detailed data for translated products
ID – translation task identifier.
- Status – status of saving the translated text.
SKU – product catalog number.
Store ID – store view where translations will be saved.
Translated Attributes – translated product fields.
Created At – date when the translation was performed.
6. Summary
The Mass Translate by ChatGPT module automates product translations, saving time and resources. You can:
- Select the language and Store View for translations.
- Monitor translation progress.
- Saved translations are available in the selected store view.
This solution significantly simplifies the management of an international product offer in Magento 2.
























