Inside Activate
Search
Search Boost
9 min
searchboost allows administrators to influence how prominently items appear in activate search results it provides a controlled way to promote important items and concepts so users find the most relevant results more quickly, without changing what content is searchable overview searchboost adjusts the relative priority of search results within activate each searchable item is assigned an internal importance score, and searchboost increases or decreases that score to influence result ordering searchboost does not affect search permissions or eligibility items must still match the search query and be visible to the user searchboost only affects how matching results are prioritised how searchboost works when activate prepares content for search, each item is assigned a base importance based on its type (for example, services, tasks, articles, and tags all have different default importance levels) searchboost modifies this base importance by adding an additional value items with higher resulting importance are prioritised ahead of similar items with lower importance this approach ensures that search behaviour remains predictable boosting is incremental rather than absolute default relevance rules remain intact types of searchboost activate supports two distinct types of searchboost, each serving a different purpose per item searchboost per item searchboost is configured by supplying a numeric searchboost parameter on a searchable object this allows administrators to directly influence the ranking of individual services, tasks, articles, folders, roles, and other resource types that appear in activate search per item searchboost applies to individual items such as services, tasks, articles, folders, or other searchable objects this is useful when one service should appear ahead of others with similar names a preferred task should be easier to find than alternatives a key article should surface before older or less relevant content each item starts with a default importance based on its type a searchboost value increases or decreases that importance relative to other items of the same type positive values promote an item so it appears higher in results, while negative values can be used to deliberately lower an item’s ranking because different item types have different base importance levels, the same searchboost value may have a stronger effect on some items than others tag searchboost tag searchboost is configured directly on the tag itself using the searchboost property in activate studio tags are searchable entities in their own right within activate tag searchboost controls how prominently a tag appears when users search tag searchboost is intended to promote important concepts or categories within your tagging strategy, rather than individual items tag behaviour includes only tags that are actively used are included in search each tag has a default importance the tag’s searchboost value is added to this default importance positive values promote the tag in search results negative values reduce the tag’s prominence compared to other tags how tags and searchboost work together searchboost and tagging are designed to complement each other while remaining independent tag searchboost promotes the concept or category per item searchboost promotes specific items for example, you might boost an important tag so it is easy to discover, while separately boosting a key service associated with that tag this separation avoids unintended ranking changes and keeps search behaviour clear and predictable when searchboost changes take effect searchboost changes are applied during the next search update cycle in most cases, an incremental search refresh is sufficient a full rebuild of the search index is not normally required when updating searchboost values changes to searchboost may not appear immediately in search results they take effect when the affected objects or tags are included in the next scheduled or triggered search refresh configuring searchboost values searchboost values are integers and can be both positive and negative in activate studio, tag searchboost values are typically configured within a bounded range to prevent extreme ranking behaviour use searchboost to make deliberate, targeted adjustments rather than broad changes to search behaviour choosing effective searchboost values searchboost is most effective when used deliberately and sparingly general guidance use small values for fine tuning relevance use moderate values to clearly promote important items avoid extreme values unless there is a strong, well understood reason always consider the item’s role within activate and how users expect search results to behave searchboost should reinforce natural relevance, not override it common misconceptions searchboost changes search results completely searchboost does not change what appears in search it only adjusts the order of matching results boosting a tag boosts everything tagged with it tag searchboost affects the tag itself items linked to the tag must be boosted separately if required higher searchboost always produces better results overusing searchboost can make search results feel inconsistent incremental adjustments provide the best user experience summary searchboost in activate provides controlled influence over search result ordering it adjusts priority, not visibility it is relative rather than absolute it supports both individual items and tagging concepts it is designed to complement activate’s default relevance behaviour used appropriately, searchboost helps users find the right content faster while maintaining consistent and predictable search behaviour