Skip to content
Draft
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@ Run the following command at the root of your documentation (where docs.json is)
mintlify dev
```

It may take you directly to `localhost:3000` which has no content. Nav to `http://localhost:3000/docs/getting-started/intro` to see our docs page.

### Publishing Changes

Install our Github App to auto propagate changes from your repo to your deployment. Changes will be deployed to production automatically after pushing to the default branch. Find the link to install on your dashboard.
Expand Down
169 changes: 157 additions & 12 deletions docs/getting-started/supported-languages.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,15 @@
---

<Info>
Please note that Hebrew, Latin American Spanish, Thai and Vietnamese have not been added to the `/languages` endpoint as they are only available in the text translation API using next-gen models. When these languages are available for all translation endpoints (including document translation) they will be added to the `/languages` endpoint and this note will be removed.
Some languages are currently only available for text translation via our next-generation models and do not yet support glossaries or tag handling. You'll find these languages below under the "Text Translation Only Languages" subheadings for both source and target language lists.

Please note that only fully-featured languages will be returned by calls to the `/languages` endpoint.
</Info>

### Translation source languages
## Translation source languages

### Fully Supported Languages
(Text translation, glossaries, and tag handling enabled):

- `AR` - Arabic
- `BG` - Bulgarian
Expand All @@ -21,7 +26,6 @@
- `ET` - Estonian
- `FI` - Finnish
- `FR` - French
- `HE` - Hebrew _(text translation via next-gen models only)_
- `HU` - Hungarian
- `ID` - Indonesian
- `IT` - Italian
Expand All @@ -38,13 +42,85 @@
- `SK` - Slovak
- `SL` - Slovenian
- `SV` - Swedish
- `TH` - Thai _(text translation via next-gen models only)_
- `TR` - Turkish
- `UK` - Ukrainian
- `VI` - Vietnamese _(text translation via next-gen models only)_
- `ZH` - Chinese _(all Chinese variants)_
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't really unrelated to your MR but since we're adding Cantonese as a T4 language, I started a thread with the chinese language team if "all chinese variants" would be confusing when we're only trying to refer to ZH-HANS and ZH-HANT https://deeplgmbh.slack.com/archives/CDW1Q2LTS/p1755718080167779


### Translation target languages
### Text Translation Only Languages
(These languages support text translation via our next-gen models only, without support for glossaries or tag handling):

- `ACE` - Acehnese

Check warning on line 52 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L52

Did you really mean 'Acehnese'?
- `AF` - Afrikaans
- `AS` - Assamese
- `AZ` - Azerbaijani
- `BA` - Bashkir
- `BE` - Belarusian
- `BHO` - Bhojpuri

Check warning on line 58 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L58

Did you really mean 'Bhojpuri'?
- `BN` - Bengali
- `BS` - Bosnian
- `CEB` - Cebuano
- `DIN` - Dinka
- `EO` - Esperanto
- `EU` - Basque
- `FA` - Persian
- `GL` - Galician
- `GOM` - Konkani

Check warning on line 67 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L67

Did you really mean 'Konkani'?
- `HA` - Hausa
- `HE` - Hebrew
- `HR` - Croatian
- `IG` - Igbo
- `JV` - Javanese
- `KK` - Kazakh
- `KY` - Kyrgyz
- `LA` - Latin
- `LB` - Luxembourgish

Check warning on line 76 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L76

Did you really mean 'Luxembourgish'?
- `LMO` - Lombard
- `LN` - Lingala

Check warning on line 78 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L78

Did you really mean 'Lingala'?
- `MAI` - Maithili

Check warning on line 79 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L79

Did you really mean 'Maithili'?
- `MG` - Malagasy
- `MI` - Maori
- `MK` - Macedonian
- `MN` - Mongolian
- `MR` - Marathi
- `MS` - Malay
- `MT` - Maltese
- `MY` - Burmese
- `NE` - Nepali
- `OC` - Occitan

Check warning on line 89 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L89

Did you really mean 'Occitan'?
- `OM` - Oromo

Check warning on line 90 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L90

Did you really mean 'Oromo'?
- `PAG` - Pangasinan

Check warning on line 91 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L91

Did you really mean 'Pangasinan'?
- `PAM` - Kapampangan

Check warning on line 92 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L92

Did you really mean 'Kapampangan'?
- `PS` - Pashto
- `RW` - Kinyarwanda

Check warning on line 94 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L94

Did you really mean 'Kinyarwanda'?
- `SA` - Sanskrit
- `SCN` - Sicilian
- `SG` - Sango

Check warning on line 97 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L97

Did you really mean 'Sango'?
- `SN` - Shona

Check warning on line 98 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L98

Did you really mean 'Shona'?
- `SO` - Somali
- `SQ` - Albanian
- `ST` - Sesotho

Check warning on line 101 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L101

Did you really mean 'Sesotho'?
- `SU` - Sundanese
- `SW` - Swahili
- `TG` - Tajik
- `TH` - Thai
- `TK` - Turkmen
- `TL` - Tagalog
- `TN` - Tswana
- `TS` - Tsonga

Check warning on line 109 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L109

Did you really mean 'Tsonga'?
- `TT` - Tatar
- `UG` - Uyghur

Check warning on line 111 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L111

Did you really mean 'Uyghur'?
- `UR` - Urdu
- `UZ` - Uzbek
- `VI` - Vietnamese
- `XH` - Xhosa
- `YO` - Yoruba
- `YUE` - Cantonese
- `ZU` - Zulu

## Translation target languages

### Fully Supported Languages
(Text translation, glossaries, and tag handling enabled):

- `AR` - Arabic
- `BG` - Bulgarian
Expand All @@ -56,11 +132,9 @@
- `EN-GB` - English (British)
- `EN-US` - English (American)
- `ES` - Spanish
- `ES-419` - Spanish (Latin American) _(text translation via next-gen models only)_
- `ET` - Estonian
- `FI` - Finnish
- `FR` - French
- `HE` - Hebrew _(text translation via next-gen models only)_
- `HU` - Hungarian
- `ID` - Indonesian
- `IT` - Italian
Expand All @@ -79,20 +153,91 @@
- `SK` - Slovak
- `SL` - Slovenian
- `SV` - Swedish
- `TH` - Thai _(text translation via next-gen models only)_
- `TR` - Turkish
- `UK` - Ukrainian
- `VI` - Vietnamese _(text translation via next-gen models only)_
- `ZH` - Chinese _(unspecified variant for backward compatibility; we recommend using_ `ZH-HANS` _or_ `ZH-HANT` _instead)_
- `ZH-HANS` - Chinese (simplified)
- `ZH-HANT` - Chinese (traditional)

### Text Translation Only Languages
(These languages support text translation via our next-gen models only, without support for glossaries or tag handling):

- `ACE` - Acehnese

Check warning on line 165 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L165

Did you really mean 'Acehnese'?
- `AF` - Afrikaans
- `AS` - Assamese
- `AZ` - Azerbaijani
- `BA` - Bashkir
- `BE` - Belarusian
- `BHO` - Bhojpuri

Check warning on line 171 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L171

Did you really mean 'Bhojpuri'?
- `BN` - Bengali
- `BS` - Bosnian
- `CEB` - Cebuano
- `DIN` - Dinka
- `EO` - Esperanto
- `ES-419` - Spanish (Latin American)
- `EU` - Basque
- `FA` - Persian
- `GL` - Galician
- `GOM` - Konkani

Check warning on line 181 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L181

Did you really mean 'Konkani'?
- `HA` - Hausa
- `HE` - Hebrew
- `HR` - Croatian
- `IG` - Igbo
- `JV` - Javanese
- `KK` - Kazakh
- `KY` - Kyrgyz
- `LA` - Latin
- `LB` - Luxembourgish

Check warning on line 190 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L190

Did you really mean 'Luxembourgish'?
- `LMO` - Lombard
- `LN` - Lingala

Check warning on line 192 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L192

Did you really mean 'Lingala'?
- `MAI` - Maithili

Check warning on line 193 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L193

Did you really mean 'Maithili'?
- `MG` - Malagasy
- `MI` - Maori
- `MK` - Macedonian
- `MN` - Mongolian
- `MR` - Marathi
- `MS` - Malay
- `MT` - Maltese
- `MY` - Burmese
- `NE` - Nepali
- `OC` - Occitan

Check warning on line 203 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L203

Did you really mean 'Occitan'?
- `OM` - Oromo

Check warning on line 204 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L204

Did you really mean 'Oromo'?
- `PAG` - Pangasinan

Check warning on line 205 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L205

Did you really mean 'Pangasinan'?
- `PAM` - Kapampangan

Check warning on line 206 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L206

Did you really mean 'Kapampangan'?
- `PS` - Pashto
- `RW` - Kinyarwanda

Check warning on line 208 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L208

Did you really mean 'Kinyarwanda'?
- `SA` - Sanskrit
- `SCN` - Sicilian
- `SG` - Sango

Check warning on line 211 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L211

Did you really mean 'Sango'?
- `SN` - Shona

Check warning on line 212 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L212

Did you really mean 'Shona'?
- `SO` - Somali
- `SQ` - Albanian
- `ST` - Sesotho

Check warning on line 215 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L215

Did you really mean 'Sesotho'?
- `SU` - Sundanese
- `SW` - Swahili
- `TG` - Tajik
- `TH` - Thai
- `TK` - Turkmen
- `TL` - Tagalog
- `TN` - Tswana
- `TS` - Tsonga

Check warning on line 223 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L223

Did you really mean 'Tsonga'?
- `TT` - Tatar
- `UG` - Uyghur

Check warning on line 225 in docs/getting-started/supported-languages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (deepl-c950b784) - vale-spellcheck

docs/getting-started/supported-languages.mdx#L225

Did you really mean 'Uyghur'?
- `UR` - Urdu
- `UZ` - Uzbek
- `VI` - Vietnamese
- `XH` - Xhosa
- `YO` - Yoruba
- `YUE` - Cantonese
- `ZU` - Zulu


## Text improvement languages (DeepL API for Write)

<Info>
As of April 2025, supported languages for [text improvement](/api-reference/improve-text) (DeepL API for Write) have not yet been added to the `/languages` endpoint; we'll be extending the `/languages` endpoint in the near future to include this information.
</Info>

### Text improvement languages (DeepL API for Write)

- `DE` (German)
- `EN-GB` (British English)
- `EN-US` (American English)
Expand Down