Skip to content

Discourage i18n.folders config #2559

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
smahati merged 2 commits into from
May 7, 2026
Merged

Discourage i18n.folders config #2559

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5bdd4ad
Update cds-i18n.md
daogrady May 7, 2026
dc4eaad
Update node.js/cds-i18n.md
daogrady May 7, 2026
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
4 changes: 2 additions & 2 deletions node.js/cds-i18n.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -655,9 +655,9 @@ cds.env.i18n = {
| `cds.i18n.folders` | An array of (relative) folder names that will be appended to the source directories in a cross-product fashion of the default `cds.model` when fetching for existing i18n [`folders`](#folders). <br />*Default:* `["_i18n","i18n"]` |
| `cds.i18n.default_language` | The locale used for [default translations](#defaults). <br />*Default:* `"en"` |

::: danger
::: danger Do not switch defaults without proper evaluation

Changing these configurations does not only affect your usage of your i18n bundles, but also all bundles provided by reuse packages you might use, including the ones provided by the CAP framework itself, such as the labels for the `@sap/cds/common` types, or the default messages used by the Node.js runtime.
Changing these configurations does not only affect your usage of your i18n bundles, but also all bundles provided by reuse packages you might use, including the ones provided by the CAP framework itself, such as the labels for the `@sap/cds/common` types, or the default messages used by the Node.js runtime. It is therefore highly recommended to leave this setting as is and adhere to the default name `_i18n` for your i18n directory.

:::

Expand Down
Loading