From 9c76057ce0a3cfe447b124c2dbdc7b9248a83d2f Mon Sep 17 00:00:00 2001 From: Anton Gritsenko Date: Thu, 9 Apr 2026 12:20:32 +0300 Subject: [PATCH] Add documentation about localizatoin files split --- docs/en/framework/fundamentals/localization.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/en/framework/fundamentals/localization.md b/docs/en/framework/fundamentals/localization.md index 562446a892..97fafbb28c 100644 --- a/docs/en/framework/fundamentals/localization.md +++ b/docs/en/framework/fundamentals/localization.md @@ -126,6 +126,10 @@ var str2 = L["Hi__0"]; // Bye World! var str3 = L["Hi__1"]; // Hello World! ```` +You can have more than one localization file with the same culture: files will be merged. + +> Note: if you have the same key with the same culture then last value will win. This is true in case of file-per-culture and several files per culture. Files are ordered alphabetically, so if a same key defined in files `!en.json` and `z_en.json` then value from file `z_en.json` will be used. + ### Default Resource `AbpLocalizationOptions.DefaultResourceType` can be set to a resource type, so it is used when the localization resource was not specified: