31 Manage Ranking Policies

Oracle Content Management uses an out-of-the-box ranking policy by default to sort search results by relevance (provided there are no orderBy clauses on the search request). However, you can create custom ranking policies to better control the relevance score of indexed items returned by a search request. You must be a content administrator to create and manage ranking policies.


  • Custom ranking policies aren't supported in Oracle Content Management Starter Edition. To take advantage of the full feature set, upgrade to the Premium Edition.
  • Ranking policies aren't used in business asset repositories.

A custom ranking policy is a collection of configurable properties that can relate to:

  • Searchable fields in assets of specific content types
  • Searchable attributes in assets of specific custom digital asset types
  • Field or attribute weighting
  • Indexed item matching behavior

Here's the basic custom ranking policy life cycle:

  1. Create a ranking policy. When you create a ranking policy, it starts as a draft.
  2. Promote the ranking policy. When you're ready to assign the ranking policy to publishing channels, you must promote it.
  3. Test the ranking policy. Use the REST APIs to test the ranking policy to make sure it has the desired affect on search results.
  4. Publish the ranking policy. To make the ranking policy available to use as a global default and apply it to users' searches, you must publish it.
  5. Use ranking policies.
  6. Edit the ranking policy. As your business changes and your understanding of how your users search your system grows, you can update your ranking policies by creating a new draft version. Changes you make in the draft won't affect the current search rankings. When the updated policy is approved, you can promote the new ranking policy version for use in your organization, and it will be applied to searches. Then you can publish the new version of the ranking policy when you're ready to make the updates public.

By default the Ranking Policies page shows all ranking policies—draft, promoted, and published—sorted by name. Use the drop-down menus on the right to filter by ranking policy status and to change the sort order. You can also use the search box to find a ranking policy by name.

You can further manage ranking policies on the Ranking Policies page in the following ways: