How to get started with the module?

PrestaShop Translator (PrestaShow) user guide

The PrestaShop Translator module enables automatic translation of your store's content using the DeepL API.
Below you'll find a step-by-step guide.

---

1. How to get started with the module?

1. Go to: PrestaShow Modules → Translate Your Store
2. Click the Translator tab

---

2. How to add a DeepL API key?

1. Register at: https://www.deepl.com/pro
2. Copy your API key
3. Paste it into the Enter new DeepL API key field
4. Click the Save button

---

3. How to choose the source and target language?

1. Choose the source language from the dropdown list
   
   


2. Choose the target language
   

---

4. How to start the translation?

After choosing the languages, the message will appear: Retrieving data about translations... – wait for the data to load.

---

5. How to translate the store?

• Once the data has loaded you will see the sections: Modules, Objects, Front Theme
• You can click Translate all or Translate all missing in this section

---

6. How to check API limit usage?

On the right side you will see the current usage: Monthly usage 0 / 500000 chars

---

7. Troubleshooting

• API key is incorrect – check whether the key is correct and active
• Translation not working – make sure the languages are selected
• Server error – increase max_execution_time in PHP (e.g. to 120 seconds)

---

8. How to change the API key?

Click the Change API key button, enter the new key and click Save.

---

9. Can translations be undone?

No. Translations make irreversible changes. We recommend making a backup before starting the translation process.

---

10. How to manage dictionaries ("Glossaries" settings)?

The module lets you add your own dictionaries (glossaries) that enforce a specific way of translating chosen phrases. They can be used in automatic mode, which saves time and increases translation consistency.

Enabling automatic use of glossaries

1. Go to the Glossaries tab
2. If the following message is shown:

   Automatic use is not active! This means that module will not use any glossary for translation.

   click the ENABLE
   
   
   
   
   button
3. Once enabled, the following message will appear:

   Automatic use is active. This means that module will automatically find glossary by language pair and use it for every translation.

   

Note: If you add more than one glossary for the same language pair, the module will only use the first one found.

Creating a new dictionary

1. Click New Glossary
2. Enter a name (e.g. Glossary 1)
3. Choose the source and target language
4. Upload a CSV or TSV file with entries
5. Click Save

Sample CSV file structure

sourceEntry1,targetEntry1
sourceEntry2,targetEntry2

Confirmation and glossary preview

After saving, the message Successful creation will appear along with a list of glossaries with a download option.

Note

The module will only use the first glossary found for a given language pair. You can add up to 1000 glossaries (up to 10 MB each).

---

Have questions? Contact the PrestaShow team or use the Report bug button in the module's top menu.