Search Boost
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.