Skip to content

Conversation

@Nis-Knowit
Copy link

@Nis-Knowit Nis-Knowit commented Dec 18, 2025

📋 Description

This PR adds documentation for the new dictionary value search feature introduced in umbraco/Umbraco-CMS#21200.

The feature allows searching dictionary items by their translation values in addition to keys. It's an opt-in configuration setting that's disabled by default to preserve backward compatibility and performance.

Changes:

  • Added new configuration documentation: 17/umbraco-cms/reference/configuration/dictionarysettings.md
  • Updated configuration index to include Dictionary Settings
  • Documented the UseDictionaryValueSearch configuration option

📎 Related Issues (if applicable)

Related to code PR: umbraco/Umbraco-CMS#21200

✅ Contributor Checklist

I've followed the Umbraco Documentation Style Guide and can confirm that:

  • Code blocks are correctly formatted.
  • Sentences are short and clear (preferably under 25 words).
  • Passive voice and first-person language ("we", "I") are avoided.
  • Relevant pages are linked.
  • All links work and point to the correct resources.
  • Screenshots or diagrams are included if useful.
  • Any code examples or instructions have been tested.
  • Typos, broken links, and broken images are fixed.

Product & Version (if relevant)

  • Product: Umbraco CMS
  • Version: 17

Deadline (if relevant)

Should be published along with the 17.2 RC due on 5th February.

📚 Helpful Resources

Updated description for clarity and recommendation.
@sofietoft
Copy link
Contributor

Thanks for the PR @Nis-Knowit ! 🙌
I'll tag this for pending release, so we can get it merged once the feature is added to the product.

Copy link
Contributor

@AndyButland AndyButland left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are a couple of small changes needed here as the code PR was worked on since this docs one was raised.

Please can you also update the "Deadline" in the PR description to say:

Should be published along with the 17.2 RC due on 5th February.

Thanks @Nis-Knowit.

@sofietoft sofietoft requested a review from AndyButland January 26, 2026 10:01
Copy link
Contributor

@AndyButland AndyButland left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the updates @Nis-Knowit - looks fine to me now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants