# Search on docs site: Do you use it? Does it work for you? **URL:** \ **Category:** Documentation\ **Tags:** documentation\ **Created:** [September 30, 2025, 5:51pm UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386 "2025-09-30T17:51:08Z")\ **Posts on this page:** 9\ **Page:** 1
**Author:** ![mrjones](https://communityhealthtoolkit.b-cdn.net/user_avatar/forum.communityhealthtoolkit.org/mrjones/32/681_2.png) [@mrjones](https://forum.communityhealthtoolkit.org/u/mrjones)\ **Post date:** [September 30, 2025, 5:51pm UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386/1 "2025-09-30T17:51:08Z")
Hi all! Recently we [upgraded](https://github.com/medic/cht-docs/pull/1978) the [docs site](https://docs.communityhealthtoolkit.org/) to the [latest version of Hextra](https://imfing.github.io/hextra/blog/v0.11/), which has enabled some great new features (This is different from the [recently added](https://forum.communityhealthtoolkit.org/t/introducing-the-new-cht-documentation-ai-assistant-powered-by-kapa-ai/5384) Kapa AI tool). My question to the community is how is search working for you? Do you use it often? Is it effective? One of the changes that the new version of Hextra brought is a refined search experience. You can see difference in this video of current site (top) vs and older copy (bottom) which illustrates some of the differences: Upon further investigation, [we found](https://github.com/medic/cht-docs/issues/2006#issuecomment-3350439155): > it gives answers to more detailed prompts: for example, if you search for `Testing Forms`, `Testing the CHT`, or `Testing Contact Summary`, or other similar prompts, you would get results. Please let us know what you think! ---
**Author:** ![jkuester](https://communityhealthtoolkit.b-cdn.net/user_avatar/forum.communityhealthtoolkit.org/jkuester/32/806_2.png) [@jkuester](https://forum.communityhealthtoolkit.org/u/jkuester)\ **Post date:** [September 30, 2025, 8:07pm UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386/2 "2025-09-30T20:07:56Z")
My initial reaction is that the new search is better. It gets me where I want to go without a lot of extra scrolling! ---
**Author:** ![jkuester](https://communityhealthtoolkit.b-cdn.net/user_avatar/forum.communityhealthtoolkit.org/jkuester/32/806_2.png) [@jkuester](https://forum.communityhealthtoolkit.org/u/jkuester)\ **Post date:** [October 1, 2025, 6:56pm UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386/3 "2025-10-01T18:56:18Z")
Okay, new complaint… 😅 I literally cannot get it to give me any results for `permissions` (even though we have [a whole page for it](https://docs.communityhealthtoolkit.org/building/reference/app-settings/user-permissions/). I can get some results if I search for `user permissions` but nothing for just `permissions`… 🤔 ---
**Author:** ![mrjones](https://communityhealthtoolkit.b-cdn.net/user_avatar/forum.communityhealthtoolkit.org/mrjones/32/681_2.png) [@mrjones](https://forum.communityhealthtoolkit.org/u/mrjones)\ **Post date:** [October 1, 2025, 9:45pm UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386/4 "2025-10-01T21:45:19Z")
Ah - interesting! This mirrors my results for `testing` . I think it will never return results for a single search term maybe? Maybe we could say “Search requires at least two search terms” or something? @andra - do you know if there’s configuration options could tweak? ---
**Author:** ![andra](https://communityhealthtoolkit.b-cdn.net/user_avatar/forum.communityhealthtoolkit.org/andra/32/1965_2.png) [@andra](https://forum.communityhealthtoolkit.org/u/andra)\ **Post date:** [October 2, 2025, 10:39am UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386/5 "2025-10-02T10:39:28Z")
I tried to change the `tokenize` parameter of the `flexsearch` to `full` in [this PR](https://github.com/medic/cht-docs/pull/2012), and the search returns slightly more results (for example, if ones searches for `Permissions`, it returns 2 results instead of 0). The complexity of the `full` option is higher, but I don’t see a visible performance degradation. It would be helpful to test the branch in the PR locally and assess if the search results return the options you were expecting. ---
**Author:** ![mrjones](https://communityhealthtoolkit.b-cdn.net/user_avatar/forum.communityhealthtoolkit.org/mrjones/32/681_2.png) [@mrjones](https://forum.communityhealthtoolkit.org/u/mrjones)\ **Post date:** [October 3, 2025, 2:58pm UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386/6 "2025-10-03T14:58:59Z")
Thanks @jkuester and @andra for the prompt research in into improving search! [The PR](https://github.com/medic/cht-docs/pull/2012#event-20074958835) you mentioned is now live and I see single words are returning results on [the docs site](https://docs.communityhealthtoolkit.org/). Anybody reading this - please drop a note here and let us know what you think of search! ---
**Author:** ![jkuester](https://communityhealthtoolkit.b-cdn.net/user_avatar/forum.communityhealthtoolkit.org/jkuester/32/806_2.png) [@jkuester](https://forum.communityhealthtoolkit.org/u/jkuester)\ **Post date:** [October 3, 2025, 4:55pm UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386/7 "2025-10-03T16:55:09Z")
> [@andra](#): > > (for example, if ones searches for `Permissions`, it returns 2 results instead of 0). 🤔 Yeah, but neither of the results are for [the page](https://docs.communityhealthtoolkit.org/building/reference/app-settings/user-permissions/#system-defined-permissions) that actually documents the user permissions… 😬 ![image](https://communityhealthtoolkit.b-cdn.net/uploads/default/original/2X/1/117d8ced36fb15f1b1407c1962ac4a455235e5d9.png) ---
**Author:** ![andra](https://communityhealthtoolkit.b-cdn.net/user_avatar/forum.communityhealthtoolkit.org/andra/32/1965_2.png) [@andra](https://forum.communityhealthtoolkit.org/u/andra)\ **Post date:** [October 6, 2025, 1:56pm UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386/8 "2025-10-06T13:56:12Z")
@jkuester are the results returned for `user permissions` in line with what you were looking for? Trying to figure out what level of prompt detail the search feature needs. ![Screenshot 2025-10-06 at 16.55.12](https://communityhealthtoolkit.b-cdn.net/uploads/default/original/2X/7/783081dfdcbf39f1a729c209c35f7e3b3dfa45c1.png) ---
**Author:** ![jkuester](https://communityhealthtoolkit.b-cdn.net/user_avatar/forum.communityhealthtoolkit.org/jkuester/32/806_2.png) [@jkuester](https://forum.communityhealthtoolkit.org/u/jkuester)\ **Post date:** [October 6, 2025, 3:27pm UTC](https://forum.communityhealthtoolkit.org/t/search-on-docs-site-do-you-use-it-does-it-work-for-you/5386/9 "2025-10-06T15:27:56Z")
Yes! Those are pretty much exactly what I want to find. 👍