Merge pull request #7734 from Nis-Knowit/feature/dictionary-value-search

Added documentation on new dictionary value search config

Author: sofietoft

17/umbraco-cms/SUMMARY.md

@@ -333,6 +333,7 @@
   * [Type finder settings](reference/configuration/typefindersettings.md)
   * [Unattended](reference/configuration/unattendedsettings.md)
   * [Web routing](reference/configuration/webroutingsettings.md)
+  * [Dictionary](reference/configuration/dictionarysettings.md)
 * [Templating](reference/templating/README.md)
   * [Models Builder](reference/templating/modelsbuilder/README.md)
     * [Introduction](reference/templating/modelsbuilder/introduction.md)

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)

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": {
+        "EnableValueSearch": false
+      }
+    }
+  }
+}
+```
+
+## EnableValueSearch
+
+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)