Promoting content search results

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

Fastpath: Admin Console > System > Search, then Content Search > Promoted Results

Promoting a result ensures that when you type certain keywords, a content item you select always appears 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 determine 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 and 2 in the results by assigning the rules priorities 0 and 1.

Note the following when promoting results:
  • Promoted search only works on documents that are visible to the entire community. You should avoid promoting any document or content access to which is restricted.
  • You can promote a maximum of two links per keyword in one language by default. If required, you can change the limit by specifying a new limit in the search.promotedResults.limit parameter.
  • 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 is returned for spotlight search queries on "quart" as well as "quarter." But if you specify "quarterly sales," your selected content is not 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.
  • Spotlight search does not need to have all promoted words in order to promote a result.

To create rules and rulesets for promoting results:

  1. In the Admin Console, go to System > Settings > Search, then open the Content Search > Promoted Results tab.
  2. Under Promoted Results Rules, in Language, select the locale for which you want to add promoted links.
  3. Under Add or Edit a rule, add a link for promotion as follows:
    1. In Priority, type the priority of the link.
      This is a number of the link in the list when the links are displayed to users. The starting number is 0.
      Priority applies only within a group multiple rules with the same keyword or keywords. The rules are automatically set in the order in which you create them. Moving a rule to a higher priority moves other rules down in priority, affecting the numbering of all rules below it: the rules above and below it are renumbered to create a sequential list.
    2. In Keywords, add one or more keywords separated by commas.
    3. In Content Link, enter the full URL of a content item.
      For example, this can be
    4. Click Add.
  4. If you want more results to be returned for the same keyword, add more rules with the same keyword and different content items.
Because the rules 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
   29. keyword2, keyword3 document n

The first ruleset says that when keyword 1 appears in a query, the first three results must 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 are documents x, r, and n.