---
title: Set up machine translations
slug: editorial/set-up-machine-translations
description: To configure bulk translations within Purple Hub, you need to set up Polylang Pro and machine translations via the DeepL API. This article will guide you through the setup process.
docTags: 
createdAt: 2024-08-30T12:50:04.605Z
---

Purple Hub

***

## Summary

To configure machine translations within Purple Hub, you need to set up Polylang Pro and machine translations via the DeepL API. This article will guide you through the setup process.

***

## Precondition

- Have a 'Super Admin' role in the Purple Hub. If you don't have a Super Admin role, contact us and we can set it up for you. We are happy to help!
- Have a Polylang Pro License Key generated. [Learn more](https://polylang.pro/doc/managing-license-keys/#:~\:text=You%20receive%20your%20license%20key,%3E%20Settings%20%3E%20License%20keys%20module.)
- Have a DeepL API Key for Translations generated. [Learn more](https://support.deepl.com/hc/en-us/articles/360020695820-API-Key-for-DeepL-s-API#:~\:text=the%20right%20%E2%80%8Cplan.-,Creating%20new%20API%20keys,keys%20depends%20on%20your%20subscription.)

***

## Enabling Polylang Pro

In Purple Hub, in the left side menu, navigate to '**Plugins**' -> '**Polylang Pro**'

![Plugins Page](https://api.archbee.com/api/optimize/sCxKkm0StdQInfax4mSE5-wqUaUi2x-toEv0fz0uyc5-20240904-090923.png "Plugins Page")

**(1) Activate** the Polylang Pro Plugin by clicking on this button

:::hint{type="info"}
Important: Make sure to activate the 'Polylang **Pro**' Plugin, not 'Polylang'. Depending on your User role, you might not be able to access the Plugins Page in Purple Hub. If this is the case, please talk to us, we are happy to help. 
:::

## Configuring Polylang Pro to work with Machine Translation

In Purple Hub, in the left side menu, navigate to '**Languages**' —> '**Settings**'

Below **License keys**, next to **Polylang Pro**, the license key coming from your Polylang subscription is stored.

**Save Changes** activates the connection to your Polylang Pro account. 

![License Keys Setup](https://api.archbee.com/api/optimize/sCxKkm0StdQInfax4mSE5-wEvo7H873oMX9GgvLbZRj-20240904-121425.png "License Keys Setup")

## Configuration of DeepL Machine Translation

In Purple Hub, in the left side menu, navigate to '**Languages**' --> '**Settings**'

For setting up the DeepL translations, scroll to **Machine Translation**

![Machine Translation Setup](https://api.archbee.com/api/optimize/ygR6KtT9QI_R0u3uKTJsm/F0_fpAkEjYbSQR6SNoySI_screenshot-2024-09-04-at-103057.png "Machine Translation Setup")

**(1) Settings** opens the setup options

**(2) Deactivate** Machine Translation in your Purple Hub 

:::hint{type="info"}
In case the setting Machine translations isn't visible on the settings page, Polylang Pro wasn't set up correctly and you should verify the setup.
:::

![Machine Translation Setup](https://api.archbee.com/api/optimize/sCxKkm0StdQInfax4mSE5-eidtemrWqHSAUx7ig_4kC-20240904-083517.png "Machine Translation Setup")

**(1)** **Data used: **As soon as the API key for DeepL is successfully enabled (see 2), this bar appears, indicating the percentage of usage of available characters for translation, according to your plan in DeepL.

**(2) **the DeepL **API key** is stored in this entry field. You can get a new API key, with a subscription to the DeepL API ([here](https://www.deepl.com/en/pro#developer)) and afterwards following the instructions on the [HelpCenter of the provider](https://support.deepl.com/hc/en-us/articles/360020695820-API-Key-for-DeepL-s-API#:~\:text=the%20right%20%E2%80%8Cplan.-,Creating%20new%20API%20keys,keys%20depends%20on%20your%20subscription.). 

**(3) Check connection to DeepL** indicates, whether the API key you created is working. If the bar has turned green, after clicking on the button, you can continue with the setup. If the bar has turned red, you API key is invalid, and you have to re-create it in order to proceed with the setup.

**(4) Formality: **Defines whether the translated text should have a formal or informal style: Choose from '**Default**'; '**Prefer formal**'; '**Prefer informal**'. If your choice is not available for the target language, the default formality will be used. 

**(5) Cancel **configuration

**(6) Save Changes** to make your configuration take effect in your Purple Hub

## Internal link handling for machine translation

When your content gets machine-translated automatically, existing links will be preserved. This can lead to situations where translated content of one language links to pages of different languages.

To prevent this, there is an option to automatically remove any *internal* links during machine translation. *External* links to other web pages will still be kept with this option enabled.

::Image[]{src="https://api.archbee.com/api/optimize/ygR6KtT9QI_R0u3uKTJsm/7bmNrXshLFgdtaSTcS8XM_screenshot-2025-02-12-at-110106.png" size="80" width="891" height="413" position="center" showCaption="false"}