# Connect DeepL for keyword translation

Add your own DeepL API key to AppNorth to translate keywords into English and fill the gaps when AppNorth localizes your keywords for new countries.

Source: https://www.appnorth.app/docs/deepl (2026-11-18)

## What DeepL does in AppNorth

DeepL is optional. AppNorth uses your own DeepL API key for keywords:

- Translate a keyword into English from the button that appears when you hover its row.
- Fill gaps in keyword localization. When you add countries, AppNorth asks your AI agent first, then DeepL for what the AI left out, then its own dictionary.
- Let your AI agent translate up to 50 terms at once with the MCP tool `translate_keywords`.

> Listing copy is written and localized by your [AI agent](https://www.appnorth.app/docs/ai-agent), not by DeepL.

## Get a DeepL API key

1. Sign up for a DeepL API plan at [deepl.com](https://www.deepl.com/pro-api). A DeepL Translator subscription is a separate product with no API key.
2. Sign in to your DeepL API account, open [API Keys & Limits](https://www.deepl.com/your-account/keys) and copy a key.

## Add it to AppNorth

1. Open **Settings → General** and find the **DeepL** section.
2. Paste the key into **API Key** and click **Save Key**.
3. Check that the row now shows **Key Saved on This Mac**.

> AppNorth doesn’t test the key when you save it. If it is wrong, DeepL translations fail without a message in the app: the hover translation shows nothing and keyword localization goes on without DeepL. Agents that call `translate_keywords` get “DeepL returned HTTP status 403.”

## Free and paid keys

Free and paid DeepL API keys both work. Keys from DeepL’s free API plan end in `:fx`, so AppNorth sends them to `api-free.deepl.com`; other keys go to `api.deepl.com`. There is nothing to choose.

Your DeepL plan’s limits and charges apply, under DeepL’s terms.

## Change or remove the key

The key is stored encrypted on this Mac, with a key kept in your Keychain, and sent only to DeepL. Workspace backups never include it.

To remove it, click **Delete** in the **DeepL** section. To change it, delete it and save the new one.

## Questions

### Do I need DeepL?

No. Without it, keyword localization uses your AI agent and AppNorth’s dictionary. Only the hover translation and the MCP tool `translate_keywords` need a key.

### Your agent reports “Add your DeepL key in Settings.”

Your agent called `translate_keywords` without a saved DeepL key. Add one in **Settings → General**, in the **DeepL** section.

### What does “DeepL did not return a translation for every keyword.” mean?

DeepL skipped some of the terms. Try again, or localize the rest with your AI agent.

### Is my DeepL key sent to AppNorth?

No. It stays encrypted on your Mac and goes only to DeepL. AppNorth has no server that receives it.
