Translate JSON files with DeepL – DeepL Help Center | How Can We Help You?

Content is translated from English using DeepL Pro.

Required plan: DeepL Pro Advanced, Ultimate, Team, Business, API Free, API Pro, API Developer, API Growth

Translate JSON files with the file translation feature via the web translator, desktop apps, or API.

When translating JSON files all string values will be considered for translation.

JSON keys, numeric values, boolean values, and nested objects will not be translated.

Example:

{"greeting": "Hello, world!"}

The string value "Hello, world!" will be translated in this case, while the key "greetings" will not be changed.

To exclude parts of your file's natural language content from translation encode them as non-strings (numbers, booleans or null). As an alternative, you can also wrap them in a key/value pair you ignore on the application side.

DeepL API subscribers can translate JSON files by using /document requests. Consult our API documentation to learn how to translate JSON files with the DeepL API.

Troubleshooting

I got an error message while uploading my file.

If your file is invalid, or if it contains trailing commas or comments (allowed in some non-standard variants like JSONC) this will result in an error.

Convert your file to a valid JSON and try to upload it again.

My JSON file is rejected for file translation because it exceeds the file size limit. What can I do?

The current upload limit for JSON is 1 MB. If your file is larger, split it into smaller JSON documents (one per top-level key or per logical section) and translate each separately.

Alternatively, extract the string values, translate them separately, and re-insert into the original JSON structure.