Languages and Locales - Mapping between Akeneo and DeepL
In order to translate text, a combination of a source and target language is required. As Akeneo uses locales to indicate different "languages", a mapping has to be made to map different locales (consisting of a language and regional part) to the supported languages by DeepL.
Supported source languages by DeepL
The languages supported by DeepL are available in their documentation.
Supported target languages by DeepL
The languages supported by DeepL are available in their documentation. Note that some languages have regional variants for target translations:
- English: EN-GB (British) and EN-US (American)
- Portuguese: PT-BR (Brazilian) and PT-PT (European)
- Spanish: ES (European) and ES-419 (Latin American)
- Chinese: ZH-HANS (Simplified) and ZH-HANT (Traditional)
Note: Some languages are only available with DeepL's quality_optimized model. These are marked with an asterisk (*) in the mapping table below.
Languages with regional variants
For languages with regional variants, the TranslatorApp uses the following logic:
English
- en_GB, en_GBL, and en_IE locales map to EN-GB (British English)
- All other English locales (en_US, en_AU, en_CA, etc.) map to EN-US (American English)
Portuguese
- pt_BR maps to PT-BR (Brazilian Portuguese)
- pt_PT maps to PT-PT (European Portuguese)
Spanish
- es_ES and es_US map to ES (European Spanish)
- All Latin American locales (es_MX, es_AR, es_CO, etc.) map to ES-419 (Latin American Spanish)
Chinese
- All Chinese locales currently map to ZH (Simplified Chinese)
- Support for ZH-HANS (Simplified) and ZH-HANT (Traditional) is available through DeepL
Mapping in the TranslatorApp for Akeneo
The mapping of locales from Akeneo to source and target languages of DeepL is automatically maintained and updated based on DeepL's current language support. The mapping outlined below shows the current supported combinations.
The system automatically:
- Matches Akeneo locales to DeepL source/target languages based on language codes
- Applies specific regional mappings for languages with variants (like EN-GB vs EN-US)
- Updates supported languages when DeepL adds new language support
Note: Akeneo locales not present in the list below cannot be translated by the TranslatorApp for Akeneo. If you use custom locale codes in your Akeneo instance, please contact TranslatorApp support to discuss adding them to your configuration.
| Locale in Akeneo | DeepL source language used | DeepL target language used |
|---|---|---|
| ar_AE | AR | AR |
| ar_BH | AR | AR |
| ar_DZ | AR | AR |
| ar_EG | AR | AR |
| ar_IQ | AR | AR |
| ar_JO | AR | AR |
| ar_KW | AR | AR |
| ar_LB | AR | AR |
| ar_LY | AR | AR |
| ar_MA | AR | AR |
| ar_OM | AR | AR |
| ar_QA | AR | AR |
| ar_SA | AR | AR |
| ar_SY | AR | AR |
| ar_TN | AR | AR |
| ar_YE | AR | AR |
| af_ZA | AF * | AF * |
| as_IN | AS * | AS * |
| az_Cyrl_AZ | AZ * | AZ * |
| az_Latn_AZ | AZ * | AZ * |
| ba_RU | BA * | BA * |
| be_BY | BE * | BE * |
| bg_BG | BG | BG |
| bn_BD | BN * | BN * |
| bn_IN | BN * | BN * |
| bs_Cyrl_BA | BS * | BS * |
| bs_Latn_BA | BS * | BS * |
| br_FR | BR * | BR * |
| ca_ES | CA * | CA * |
| cs_CZ | CS | CS |
| cy_GB | CY * | CY * |
| da_DK | DA | DA |
| de_AT | DE | DE |
| de_CH | DE | DE |
| de_DE | DE | DE |
| de_LI | DE | DE |
| de_LU | DE | DE |
| el_GR | EL | EL |
| en_029 | EN | EN-US |
| en_AU | EN | EN-US |
| en_BZ | EN | EN-US |
| en_CA | EN | EN-US |
| en_GB | EN | EN-GB |
| en_GBL | EN | EN-GB |
| en_IE | EN | EN-GB |
| en_IN | EN | EN-US |
| en_JM | EN | EN-US |
| en_MY | EN | EN-US |
| en_NZ | EN | EN-US |
| en_PH | EN | EN-US |
| en_SG | EN | EN-US |
| en_TT | EN | EN-US |
| en_US | EN | EN-US |
| en_ZA | EN | EN-US |
| en_ZW | EN | EN-US |
| es_AR | ES | ES-419 |
| es_BO | ES | ES-419 |
| es_CL | ES | ES-419 |
| es_CO | ES | ES-419 |
| es_CR | ES | ES-419 |
| es_DO | ES | ES-419 |
| es_EC | ES | ES-419 |
| es_ES | ES | ES |
| es_GT | ES | ES-419 |
| es_HN | ES | ES-419 |
| es_MX | ES | ES-419 |
| es_NI | ES | ES-419 |
| es_PA | ES | ES-419 |
| es_PE | ES | ES-419 |
| es_PR | ES | ES-419 |
| es_PY | ES | ES-419 |
| es_SV | ES | ES-419 |
| es_US | ES | ES |
| es_UY | ES | ES-419 |
| es_VE | ES | ES-419 |
| et_EE | ET | ET |
| eu_ES | EU * | EU * |
| fa_IR | FA * | FA * |
| fil_PH | TL * | TL * |
| fi_FI | FI | FI |
| fr_BE | FR | FR |
| fr_CA | FR | FR |
| fr_CH | FR | FR |
| fr_FR | FR | FR |
| fr_LU | FR | FR |
| fr_MC | FR | FR |
| ga_IE | GA * | GA * |
| gl_ES | GL * | GL * |
| gu_IN | GU * | GU * |
| ha_Latn_NG | HA * | HA * |
| he_IL | HE | HE |
| hi_IN | HI * | HI * |
| hr_BA | HR * | HR * |
| hr_HR | HR * | HR * |
| hu_HU | HU | HU |
| hy_AM | HY * | HY * |
| id_ID | ID | ID |
| ig_NG | IG * | IG * |
| is_IS | IS * | IS * |
| it_CH | IT | IT |
| it_IT | IT | IT |
| ja_JP | JA | JA |
| ka_GE | KA * | KA * |
| kk_KZ | KK * | KK * |
| ko_KR | KO | KO |
| kok_IN | GOM * | GOM * |
| ky_KG | KY * | KY * |
| lb_LU | LB * | LB * |
| lt_LT | LT | LT |
| lv_LV | LV | LV |
| mi_NZ | MI * | MI * |
| mk_MK | MK * | MK * |
| ml_IN | ML * | ML * |
| mn_MN | MN * | MN * |
| mn_Mong_CN | MN * | MN * |
| mr_IN | MR * | MR * |
| ms_BN | MS * | MS * |
| ms_MY | MS * | MS * |
| mt_MT | MT * | MT * |
| nb_NO | NB | NB |
| ne_NP | NE * | NE * |
| nl_BE | NL | NL |
| nl_NL | NL | NL |
| oc_FR | OC * | OC * |
| pa_IN | PA * | PA * |
| pl_PL | PL | PL |
| prs_AF | PRS * | PRS * |
| ps_AF | PS * | PS * |
| pt_BR | PT | PT-BR |
| pt_PT | PT | PT-PT |
| ro_RO | RO | RO |
| ru_RU | RU | RU |
| sa_IN | SA * | SA * |
| sk_SK | SK | SK |
| sl_SI | SL | SL |
| sq_AL | SQ * | SQ * |
| sr_Cyrl_BA | SR * | SR * |
| sr_Cyrl_CS | SR * | SR * |
| sr_Cyrl_ME | SR * | SR * |
| sr_Cyrl_RS | SR * | SR * |
| sr_Latn_BA | SR * | SR * |
| sr_Latn_CS | SR * | SR * |
| sr_Latn_ME | SR * | SR * |
| sr_Latn_RS | SR * | SR * |
| sv_FI | SV | SV |
| sv_SE | SV | SV |
| sw_KE | SW * | SW * |
| ta_IN | TA * | TA * |
| tg_Cyrl_TJ | TG * | TG * |
| te_IN | TE * | TE * |
| th_TH | TH | TH |
| tk_TM | TK * | TK * |
| tr_TR | TR | TR |
| tt_RU | TT * | TT * |
| uk_UA | UK | UK |
| ur_PK | UR * | UR * |
| uz_Cyrl_UZ | UZ * | UZ * |
| uz_Latn_UZ | UZ * | UZ * |
| vi_VN | VI | VI |
| wo_SN | WO * | WO * |
| xh_ZA | XH * | XH * |
| zh_CN | ZH | ZH |
| zh_HK | ZH | ZH |
| zh_MO | ZH | ZH |
| zh_SG | ZH | ZH |
| zh_TW | ZH | ZH |
| zu_ZA | ZU * | ZU * |
Note: Languages marked with * require DeepL's quality_optimized model and are not compatible with the latency_optimized model.
Unsupported locales
The following Akeneo distribution locales are not currently supported because DeepL does not support their languages:
| Locale | Language |
|---|---|
| am_ET | Amharic |
| arn_CL | Mapudungun |
| bo_CN | Tibetan |
| co_FR | Corsican |
| dsb_DE | Lower Sorbian |
| dv_MV | Divehi |
| fo_FO | Faroese |
| fy_NL | Frisian |
| gd_GB | Scottish Gaelic |
| gsw_FR | Alsatian |
| hsb_DE | Upper Sorbian |
| ii_CN | Yi |
| iu_Cans_CA | Inuktitut (Syllabics) |
| iu_Latn_CA | Inuktitut (Latin) |
| kl_GL | Greenlandic |
| km_KH | Khmer |
| kn_IN | Kannada |
| lo_LA | Lao |
| moh_CA | Mohawk |
| nn_NO | Norwegian (Nynorsk) |
| nso_ZA | Sesotho sa Leboa |
| or_IN | Odia |
| qut_GT | K'iche' |
| quz_BO | Quechua (Bolivia) |
| quz_EC | Quechua (Ecuador) |
| quz_PE | Quechua (Peru) |
| rm_CH | Romansh |
| rw_RW | Kinyarwanda |
| sah_RU | Sakha |
| se_FI | Sami (Northern, Finland) |
| se_NO | Sami (Northern, Norway) |
| se_SE | Sami (Northern, Sweden) |
| si_LK | Sinhala |
| sma_NO | Sami (Southern, Norway) |
| sma_SE | Sami (Southern, Sweden) |
| smj_NO | Sami (Lule, Norway) |
| smj_SE | Sami (Lule, Sweden) |
| smn_FI | Sami (Inari) |
| sms_FI | Sami (Skolt) |
| syr_SY | Syriac |
| tn_ZA | Setswana |
| tzm_Latn_DZ | Tamazight |
| ug_CN | Uyghur |
| yo_NG | Yoruba |