DeepL

1. Activate several languages in your store

For the DeepL plugin to work at all, you need to activate the desired languages in your online store.

• Open the administration interface: my.saldia.ch
• Navigate to the menu item "Settings."
• Select the setting "Languages."
• Define the languages into which you want to translate your products.
• Select the "Save changes" button.

2. Activate the DeepL app

To be able to use the automated translation, you must first activate the saldia app "DeepL" in the administration interface.

• Open the administration interface: my.saldia.ch
• Select the menu item "saldiaApps." in the navigation bar
• Search for the app "DeepL."
• Activate the app with the "Add." button
• Select the "Save changes" button.
• We will configure the other fields and settings for the app later, as we first need to open a DeepL account.

3. Open an account for API access at DeepL

For the saldia app "DeepL" to work, we need an active account at "DeepL".

• Open the website: www.deepl.com
• Navigate to the menu item "API."
• Go to the "Packages" section further down on the website.
• Select the appropriate package and click on the corresponding button:
  • DeepL API Free (free)
  • DeepL API Pro (chargeable)
• Enter all user data and create your DeepL account.

4. Copy your DeepL API key

An API key is required for communication between the Saldia app and the DeepL service. This is used for identification.

• Open the website: www.deepl.com
• Log in with your user account if you are not already logged in.
• Click on the menu item in which your e-mail address is displayed within a button (top right).
• Now select the menu item "Account."
• Select the "Account." tab
• Go to the section "Authentication key for the DeepL API."
• Copy the API key (a long combination of numbers and letters).

5. Link your DeepL account with the saldia app

• Open the administration interface: my.saldia.ch
• Select the menu item "saldiaApps" in the navigation bar.
• Configure the app with the "Edit" button.
• Now add the "API key" from your DeepL account in the "API key" field.
• Select the "Save changes" button.

6. Configure the saldia app "DeepL"

Determine which product fields are translated and according to which criteria.

• Open the administration interface: my.saldia.ch
• Select the menu item "saldiaApps." in the navigation bar
• Configure the app with the "Edit." button
• Important: Ignore the newly displayed function "Translate with DeepL"; this function will be described in more detail later.

• Select the status that a product must have in order to be translated after saving.
• Select the languages into which a product should be translated.
  • Example "All": Every change you make, regardless of the language, is automatically translated into all other languages.
  • Example "English, French": Every change you make in "German" or "Italian" is automatically translated into the languages "English & French".
• Use the slider to determine which product fields should be translated:
  • Translate product descriptions
  • Translate product titles. Important: When using "brand names" or "standard language" terms, the translation must be checked manually, as DeepL does not always translate correctly.
  • Translate short descriptions
  • Translate promotional texts
  • SEO name
  • Page title
  • Meta description
• Click on the "Save changes" button.

7. Translate all existing products with one click

You have the option of translating all existing products in your online store with just one click, without having to open each product individually.

• Open the administration interface: my.saldia.ch
• Select the menu item "saldiaApps" in the navigation bar.
• Configure the app with the "Edit" button.

• Above the "API Key" field, there is a function called "Translate with DeepL".
• Use the selection field to determine the languages from which the current products should be translated.
• Use the corresponding slider to configure whether DeepL may overwrite the existing translations on all products. Otherwise, only the product fields that do not yet have any content will be translated.
• Start the process to translate all products with the "Translate all products" button.

8. Translate an existing product

• Open the administration interface: my.saldia.ch
• Select the menu item "Products." in the navigation bar
• Open the relevant product.
• Switch to the tab with the language to be translated.
• Delete the content from all fields that are to be translated.
• Save the changes.

9. Translate a new product

• Open the administration interface: my.saldia.ch
• Select the menu item "Products." in the navigation bar
• Press the "Add product" button.
• Fill in all fields with the required content and media.
• Important: Only save when all texts, including in the SEO area, are complete.
• Save the data record. This activates DeepL in the background and all translations are carried out.