Promoting Content Search Results

You can create rulesets to ensure that particular keywords always return specific content results, even when that keyword does not occur in the content.

Fastpath: Admin Console: System > Settings > Search > Content Search > Promoted Results

Promoting a result ensures that when you type certain keywords, a content item you select will always be at the top of the results. You can associate multiple keywords or key phrases with a single content item by entering the terms separated by commas. You can also associate different content items with the same keyword, so that several content items show up when a user queries that keyword. Use the Priority field to detemine which promoted results for a keyword appear first. For example, if you wanted the European, American, and Asian holiday schedules in your organization to be promoted for the keyword “holidays”, you could create a rule for each document linking it to the keyword “holidays.” Then you could rank these schedules 1, 2, and 3 in the results by assigning the rules priorities 0, 1, and 2.

Keep in mind the following limitations when promoting results:

Keywords must be at least three characters long.
Single keywords can function as wildcards in spotlight search, but when you specify a key phrase, the query must be an exact match for the key phrase. (Standard searches typed in the search page, or entered by typing in the search field and pressing Enter do not support wildcards unless you type * as part of the string.) For example, if you specify "quarter" as a keyword, your selected content will be returned for spotlight search queries on "quart" as well as "quarter." But if you specify "quarterly sales," your selected content will not be returned for queries on "quarter," "quarter sales," "quarterly," or "sales," only for queries on "quarterly sales."
No two rules can have the same priority number, so multiple rules for the same keyword or keyword combination must be in sequential order.

Note: Spotlight search does not need to have all promoted words in order to promote a result.

To create rules and rulesets for promoting results:

In the Keyword(s) field, add one or more keywords separated by commas.
In the Content Link field, type the full URL of a content item, for example https://yourcommunity.com/docs/DOC-46692.
Click Add.
If you want more results to be returned for the same keyword(s), add more rules with the same keyword(s) and different content. Then assign a priority to each rule within the group of rules. You can do this automatically by creating the rules in order of document priority, but you can also edit the Priority field after a rule is created to move it anywhere in the list. Moving a rule to a higher priority will move other rules down in priority, affecting the numbering of all rules below it. Priority applies only within a group multiple rules with the same keyword or keywords. Note that when you change the priority of an existing rule, the rules above and below it will be renumbered to create a sequential list.
Because the rules will appear in one sequential list, you might end up with a sequence like this one, which represents two rulesets:
```
   24. keyword1 document g
   25. keyword1 document a
   26. keyword1 document q
   27. keyword2, keyword3 document x
   28. keyword2, keyword3 document r
   28. keyword2, keyword3 document n
```
The first ruleset says that when keyword 1 appears in a query, the first three results will be documents g, a, and q. The second ruleset says that when either keyword 2 or keyword 3 appears in a query, the first three results will be documents x, r, and n.