User Guide for Magento 2 AI Locale Translator

Magento 2 AI Locale Translator is an AI-powered extension that automatically translates Magento store content into multiple languages.

It uses advanced AI models, allowing translation via either a Preconfigured Model or a selected LLM Provider for automated multilingual content generation.
This helps you manage both frontend and backend content quickly and without manual effort.

Managing multilingual content manually takes time and often leads to errors.It also creates inconsistency across store views and product data.

This module solves these issues by automating translations and keeping content consistent.
It improves accuracy and saves time for store owners and teams.

This extension is ideal for businesses that want to expand into global markets.
It helps deliver a seamless and localized shopping experience across multiple languages.

Now, if you want to generate an AI concise product review summary on the product pages you can check the Magento 2 AI Product Review Summary Extension.

You can also go through the below video to get to know the functionality.

• Automatically generates and saves AI-based translations for Magento 2 products, categories, CMS pages, and module locale content.
• Translates product content, including titles, descriptions, and related details, into multiple languages.
• Enables translation of product attributes to help manage multilingual product data easily.
• Supports translation of categories to keep catalog structure consistent across store views.
• Integrates with multiple AI platforms through a unified integration system.
• Validates LLM credentials in real time.
• Supports dual AI configuration modes with Preconfigured Model or LLM Provider selection for flexible translation setup.
• Allows CMS page translation in Magento 2 to deliver localized content and improve user experience.
• Translates CSV locale files (e.g., en_US.csv) into any target language.
• Translates Magento 2 modules for complete storefront and admin panel localization.
• Automates CSV file translation based on store views.
• Provides a multilingual store experience effortlessly.
• Allows easy enable or disable control of the module.
• Provides options to download, delete, and manage translation files efficiently.
• Displays translation process status for better tracking and control.
• Improves translation accuracy and multilingual SEO performance with AI-powered processing.

#1 Download Module

Firstly, you need to log in to the Webkul Store, go to My Account>My Purchased Products section, verify, and then download and extract the contents of this zip folder on the system.

#2 Upload Folder

Once the module zip is extracted, follow path src>app and then copy the app folder into the Adobe Commerce Cloud root directory on the server as shown below:

#3 Run Commands

After uploading the module folder, you need to run the following commands in the Magento 2 root directory:

composer require symfony/ai-platform:0.6.*

php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy

php bin/magento indexer:reindex

php bin/magento cache:flush

php bin/magento cron:install

php bin/magento cron:run

php bin/magento queue:consumers:start ailocaltranslator.translation.generate &

php bin/magento queue:consumers:start ailocaltranslator.product.translate &

If you need to do the module translation, please navigate to the following path in your system app/code/Webkul/AILocaleTranslator/i18n.

Open the file named en_US.csv for editing as shown in the below screenshot.

Once you have opened the file for editing. Replace the words after the†comma(,)†on the right with your translated words.

After editing and translating the CSV file, you need to save the translated file name according to your region language and country code such as – de_DE.csv.

Then upload the translated file to the same folder from where you obtained it. Now your module translation is complete.

To use AI-powered translation services, generate an API key from your preferred LLM provider using the links below:

• OpenAI API Key: Generate your OpenAI API key here
• Gemini AI API Key: Generate your Google Gemini AI API key here
• Anthropic API Key: Generate your Anthropic API key here
• OpenRouter API Key: Generate your OpenRouter API key here
• Cerebras API Key: Generate your Cerebras API key here
• DeepSeek API Key: Generate your DeepSeek API key here

Note – If you want to translate your product reviews then you can use our Magento 2 AI Review translator extension for translation.

After successfully installing the AI Locale Translator module, the admin can navigate to: Stores → Configuration → Webkul → AI Locale Translator → General Settings

The following configuration options are available for the admin:

General Settings:

• Enable Module: Dropdown to enable or disable the extension.
• AI Model Type: Dropdown to select the type of AI model configuration for translation.
• Server Endpoint URL: Field to input the Server Endpoint URL. (Visible when Pre Configured Model is selected as AI Model Type.)
• Fetch Models: Button to fetch Models. (Available when Pre Configured Model is selected as AI Model Type.)
• Preconfigured Model: Dropdown to select fetched model. (Visible when Pre Configured Model is selected as AI Model Type.)
• LLM Provider: Dropdown to select the LLM Provider. (Available when LLM Provider is selected as AI Model Type.)
• LLM API Key: Field to input the LLM API Key. (Visible when LLM Provider is selected as AI Model Type.)
• Translation Model: Dropdown to select the model used for translation. (Available when LLM Provider is selected as AI Model Type.)
• LLM validation: Button to validate the entered credentials. (Visible when LLM Provider is selected as AI Model Type.)
• Max Tokens: Field to input Max Tokens. (Available when LLM Provider is selected as AI Model Type.)

Configuration when Pre Configured Model is selected as AI Model Type:

• AI Model Type: Select Pre Configured Model as AI Model Type.
• Server Endpoint URL: Input the Server Endpoint URL.
• Fetch Models: Button to fetch Models
• Preconfigured Model: Select the preferred fetched model.

Configuration when LLM Provider is selected as AI Model Type:

• AI Model Type: Select LLM Provider as AI Model Type.
• LLM Provider: Choose the Large Language Model service provider. Here the admin will get 6 options for LLM Provider-
  1. OpenAI
  2. Gemini AI
  3. Anthropic
  4. OpenRouter
  5. Cerebras
  6. DeepSeek
• LLM API Key: Enter the API key of the selected LLM Provider
• Translation Model: Select the preferred model to use for translation.
• LLM validation: Click to validate the entered credentials and provider configuration.
• Max Tokens: Enter the Max Tokens.

Click the Save Config button to apply and save the configuration changes.

• To configure the Locale Language, first navigate to Stores → Configuration.
• Next, select the Store View for which you want to configure the language from the scope dropdown at the top-left corner.
• Then navigate to General → General → Locale Options.
• Next, choose the Locale Language according to the language you want to apply for the selected store view.
• Once the locale language is configured for the store view, you can proceed to generate translations.

To create and manage translation, navigate to AI Locale Translator from the admin sidebar menu.

This has three sections:

• Create Translation: Create translation for selected Magento default and installed modules.
• Translation List: View, Delete, and Download the translation files.
• Configurations: Module configuration.

• Navigate to AI Locale Translator → Create Translation to start generating translation files.
• Select the target language from the Select Language Translate To field.
  The list shows languages configured for available store views.
• Choose the modules you want to translate from the Select Module section.
  This lets you control which content gets translated.
• Click the Generate button to start the translation process.
• The module begins processing based on your selected options.
  The system automatically generates translated CSV files for selected modules.

Note: You can select multiple modules and multiple languages at the same time to generate translation files in bulk.

• First, navigate to Catalog → Products to start product translation.
• Then, select the checkbox for the product(s) you want to translate.
  You can choose multiple products for bulk translation.
• Next, click the Actions dropdown above the product grid.
  Then, click on Translate Products.
• Then, select Translate to [Store View] based on your target language.
• After that, click the OK button to confirm the action.
• The system will start the translation process automatically.
• Finally, the module translates product content and supported attributes.
  It saves the translated data for the selected store view language.

Note: You can use CLI commands to generate product translations.

php bin/magento ailocaltranslator:translate:product [-s|--store="store_codes"] [-p|--product-id="ID"]

• First, navigate to Catalog → Categories in Magento Admin Panel.
• Then, select the category you want to translate from the category tree.
• Next, click the Translate button available on the category page.
• A popup will appear with available store views.
• Then, select the store view(s) for translation or choose Select All Stores.
  This lets you translate the category into multiple languages at once.
• After that, click the Translate/OK button to start the process.
  The system will begin translating the selected category data.

Note: You can use CLI commands to generate categories translations.

php bin/magento ailocaltranslator:translate:category [-s|--store="store_codes"] [-c|--category-id="ID"]

• First, navigate to Stores → Attributes → Product from Magento Admin Panel.
• Then, select the checkbox for the attribute(s) you want to translate.
  You can choose multiple attributes for bulk translation.
• Next, click the Actions dropdown above the attributes grid.
  Then, select Translate to [Store View] based on your target language.
• After that, click the Submit/OK button to confirm the action.
• The system will start the translation process automatically.
• Finally, the module translates selected product attribute labels.
  It saves the translated content for the selected store view language.

• First, navigate to Content → Pages in Magento Admin Panel.
• Then, select the checkbox for the CMS page(s) you want to translate.
  You can choose multiple pages for bulk translation.
• Next, click the Actions dropdown above the pages grid.
  Then, select Translate to [Store View] based on your target language.
• After that, click the Submit/OK option to confirm the action.
• The system will start the translation process automatically.

Note: You can use CLI commands to generate CMS pages translations.

php bin/magento ailocaltranslator:translate:cms-default-pages -s store_code [-p|--page-id="ID"] [-i|--identifier="IDENTIFIER"]

To view translation files, navigate to AI Locale Translator → Translation List.

Here, all generated translations are listed in one place for easy review and management. From this section, the admin can:

• Check the status of all the translations.
• Check source language, target language, translation type, and module name.
• Access the file path of the generated translation.
• Download the translated CSV file directly.
• Delete the translated CSV file.

• To view translated content in the admin panel, first change the Interface Locale language.
• Go to Admin User Settings → Interface Locale and select your desired language.
• Then, save the settings to apply the selected language.
• The admin panel will update based on your chosen locale.
• Finally, the translated modules will show localized content in the admin panel.
  Refer to the images below to see the applied translations.

• After the translation process is complete, go to the storefront of your Magento store.
• Then, switch to the store view for which the translation was generated.
• After that, the translated content will appear across the storefront.
  All updates will reflect based on the selected store view language.
• The module interface text, labels, and storefront elements will display in the selected language.
  This provides a localized and seamless experience for customers.
• Finally, refer to the images below to see how the translated module appears.
• These examples show the applied translations on the storefront.

That is all about the Magento 2 AI Locale Translator extension. 

If you have any queries regarding the plugin, please contact us at Webkul Support System.

You may also check our top-quality Magento 2 AI Extensions.