From 09d915fdbdb7d5a76626bb0267acea7c620d9587 Mon Sep 17 00:00:00 2001 From: Pierre Wizla Date: Mon, 22 Sep 2025 17:17:07 +0200 Subject: [PATCH 1/4] Add context for admin locales and translations --- .../locales-translations.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docusaurus/docs/cms/admin-panel-customization/locales-translations.md b/docusaurus/docs/cms/admin-panel-customization/locales-translations.md index b4ae78facf..c7993abbad 100644 --- a/docusaurus/docs/cms/admin-panel-customization/locales-translations.md +++ b/docusaurus/docs/cms/admin-panel-customization/locales-translations.md @@ -11,12 +11,17 @@ tags: # Locales & translations -Strapi's [admin panel](/cms/admin-panel-customization) always ships with English translations, but can display additional languages. You can also override any text that appears in the interface. -The present page shows how to define your own locales and extend Strapi or plugin translations from the project codebase. + +Configure the admin panel languages by updating the `config.locales` array and override default or plugin strings with `config.translations` or custom translation files. + + +The Strapi [admin panel](/cms/admin-panel-customization) ships with English strings and supports adding other locales so your editorial team can work in their preferred language. Locales determine which languages appear in the interface, while translations provide the text displayed for each key in a locale. + +This guide targets project maintainers customizing the admin experience from the application codebase. All examples modify the configuration exported from `/src/admin/app.[jt]s`, which Strapi loads when the admin panel builds. You'll learn how to declare additional locales and how to extend Strapi or plugin translations when a locale is missing strings. ## Defining locales -To update the list of available locales in the admin panel, use the `config.locales` array: +To update the list of available locales in the admin panel, set the `config.locales` array in `src/admin/app.[jt]s`: @@ -57,7 +62,7 @@ export default { Translation key/value pairs are declared in `@strapi/admin/admin/src/translations/[language-name].json` files. -These keys can be extended through the `config.translations` key: +These keys can be extended through the `config.translations` key in `src/admin/app.[jt]s`: @@ -151,4 +156,4 @@ export default { -If more translations files should be added, place them in the `/src/admin/extensions/translations` folder. +If you need to ship additional translation JSON files—for example to organize large overrides or to support a locale not bundled with Strapi—place them in the `/src/admin/extensions/translations` folder and ensure the locale code is listed in `config.locales`. From fe3de402921a0c5a5133324f97ad1cbe2529a148 Mon Sep 17 00:00:00 2001 From: Pierre Wizla Date: Mon, 22 Sep 2025 17:18:00 +0200 Subject: [PATCH 2/4] Formatting --- .../docs/cms/admin-panel-customization/locales-translations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docusaurus/docs/cms/admin-panel-customization/locales-translations.md b/docusaurus/docs/cms/admin-panel-customization/locales-translations.md index c7993abbad..9db88c84dd 100644 --- a/docusaurus/docs/cms/admin-panel-customization/locales-translations.md +++ b/docusaurus/docs/cms/admin-panel-customization/locales-translations.md @@ -17,7 +17,7 @@ Configure the admin panel languages by updating the `config.locales` array and o The Strapi [admin panel](/cms/admin-panel-customization) ships with English strings and supports adding other locales so your editorial team can work in their preferred language. Locales determine which languages appear in the interface, while translations provide the text displayed for each key in a locale. -This guide targets project maintainers customizing the admin experience from the application codebase. All examples modify the configuration exported from `/src/admin/app.[jt]s`, which Strapi loads when the admin panel builds. You'll learn how to declare additional locales and how to extend Strapi or plugin translations when a locale is missing strings. +This guide targets project maintainers customizing the admin experience from the application codebase. All examples modify the configuration exported from `/src/admin/app`file, which Strapi loads when the admin panel builds. You'll learn how to declare additional locales and how to extend Strapi or plugin translations when a locale is missing strings. ## Defining locales From 10793704086007200fbc499d84e4fb0f72d388ab Mon Sep 17 00:00:00 2001 From: Pierre Wizla Date: Mon, 22 Sep 2025 17:18:31 +0200 Subject: [PATCH 3/4] Formatting --- .../docs/cms/admin-panel-customization/locales-translations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docusaurus/docs/cms/admin-panel-customization/locales-translations.md b/docusaurus/docs/cms/admin-panel-customization/locales-translations.md index 9db88c84dd..fc57e03590 100644 --- a/docusaurus/docs/cms/admin-panel-customization/locales-translations.md +++ b/docusaurus/docs/cms/admin-panel-customization/locales-translations.md @@ -21,7 +21,7 @@ This guide targets project maintainers customizing the admin experience from the ## Defining locales -To update the list of available locales in the admin panel, set the `config.locales` array in `src/admin/app.[jt]s`: +To update the list of available locales in the admin panel, set the `config.locales` array in `src/admin/app` file: From e61ecf92678825e69fab36f05664e8a82dbe63a5 Mon Sep 17 00:00:00 2001 From: Pierre Wizla Date: Mon, 22 Sep 2025 17:18:49 +0200 Subject: [PATCH 4/4] Formatting --- .../docs/cms/admin-panel-customization/locales-translations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docusaurus/docs/cms/admin-panel-customization/locales-translations.md b/docusaurus/docs/cms/admin-panel-customization/locales-translations.md index fc57e03590..f8c7df02a8 100644 --- a/docusaurus/docs/cms/admin-panel-customization/locales-translations.md +++ b/docusaurus/docs/cms/admin-panel-customization/locales-translations.md @@ -62,7 +62,7 @@ export default { Translation key/value pairs are declared in `@strapi/admin/admin/src/translations/[language-name].json` files. -These keys can be extended through the `config.translations` key in `src/admin/app.[jt]s`: +These keys can be extended through the `config.translations` key in `src/admin/app` file: