Using title~ when configuring CQL
When configuring a CQL for the search function, it might be easier to choose text~ over title~ as using text~ would ensure that users would be able to find all content that contains the relevant term. However, this can turn out to be frustrating for users, especially when the search scope is a huge confluence space whereby the search would find and return all content which could include texts within attachments / page / blogpost which users might not want to be looking at.
Below, we show a comparison in results obtained when using text~ vs when using title~.
As shown, when configured using title~, users will be able to optimise their search to obtain results which only looks at title of the attachments, while with text~ users will obtain 8 results as the content of attachments are also checked. Depending on the requirements of users, choosing title~ can effectively improve the scope applicable for the search function to improve users experience.
Using wildcard (*) for searches by default
...
Problem
...
Too much content
Search returns too many results
More than often, we only need to search by the page title
Proposed Solution
...
Use CQL title~ instead of text~ when configuring CQL
Using text~ | Using title~ |
|---|---|
| |
title~ search is based on exact word match. A tip would be to include wildcard at the end of all query to include title results with slight variation in the naming. (e.g. guide, guideline, guides).
Excluding wildcard ($$query$$) | Including wildcard ($$query*$$) |
|---|---|
 |  |
| Info |
|---|
Wildcards Using an asterisk (*) to replace multiple characters. Examples
|
...
In this case, users might feedback that the search function is not effective or broken, as searching for “guide”, they would only be getting 3 results as shown below, even though there are several other attachments which also contain “guide” in the title.
...
For many users, the above issue can be solved if they had added a wildcard at the end of their search term (i.e. guide*).
To improve the search functionality to cater to these users, it is recommended that the wildcard (*) be defined to be attached to the end for all search terms by default. This can be achieved through the use of $$query*$$ when configuring CQL rather than $$query$$ as shown below.
...
Using appropriate CQL to limit the scope
...
|