diff --git a/17/umbraco-cms/reference/configuration/README.md b/17/umbraco-cms/reference/configuration/README.md index 263975541f9..d1e29045758 100644 --- a/17/umbraco-cms/reference/configuration/README.md +++ b/17/umbraco-cms/reference/configuration/README.md @@ -120,6 +120,7 @@ A complete list of all the configuration sections included in Umbraco, by defaul * [Connection strings settings](connectionstringssettings.md) * [Content settings](contentsettings.md) * [Debug settings](debugsettings.md) +* [Dictionary settings](dictionarysettings.md) * [Distributed jobs settings](distributedjobssettings.md) * [Examine settings](examinesettings.md) * [Exception filter settings](exceptionfiltersettings.md) diff --git a/17/umbraco-cms/reference/configuration/dictionarysettings.md b/17/umbraco-cms/reference/configuration/dictionarysettings.md new file mode 100644 index 00000000000..defa4f8220b --- /dev/null +++ b/17/umbraco-cms/reference/configuration/dictionarysettings.md @@ -0,0 +1,42 @@ +--- +description: "Information on the dictionary settings section." +--- + +# Dictionary Settings + +Dictionary settings allow you to configure how dictionary items are searched in the Umbraco backoffice. + +The following snippet contains all the available options with their default values: + +```json +{ + "Umbraco": { + "CMS": { + "Dictionary": { + "UseDictionaryValueSearch": false + } + } + } +} +``` + +## UseDictionaryValueSearch + +Key: `UseDictionaryValueSearch` + +Type: `bool` (default: `false`) + +Enables searching dictionary items by their **translation values** in addition to **keys** in the backoffice. + +When set to `false` (default), only dictionary keys are searched using prefix matching. + +When set to `true`, both dictionary keys and translation values are searched. Keys use prefix matching while values use substring matching, allowing editors to find dictionary items by their translated content. + +{% hint style="info" %} +This feature is **disabled by default** to preserve backward compatibility and performance. It is recommended to enable the setting only when your editors need to search by translation values. +{% endhint %} + +## Related Links + +- [Dictionary Items](../../fundamentals/data/dictionary-items.md) +- [Creating a Multilingual Site](../../tutorials/multilanguage-setup.md)