Ranking of Search Results

Still need help?

The Atlassian Community is here for you.

Ask the community

When you perform a search in Confluence, it is likely that there will be many pages or other content items that match your search terms.

Confluence will rank these matching items by evaluating their relevance. This should mean that the items most relevant to you will appear at the top of the search results list so that you can quickly select the item you need.

Below is an overview of the method Confluence uses to determine the relevance of the items returned by the search, that is, to rank the search results.

Summary of the ranking method

When displaying the search results, Confluence applies a weighting to each of the content items returned.

To come up with this single weighting, Confluence first combines three separate weightings based on the following factors:

  1. The content type of the matching item – this includes user profiles, pages, blog posts, images and other attachments, etc. More details below
  2. The field type in which the matching term was found – this includes title, name, body content, labels, etc. More details below
  3. The recency of the matching item – that is, when it was created or last modified; this could be today, yesterday, up to 1 week ago, up to 1 year ago, or over 1 year ago. More details below

The item with the heaviest final weighting will appear at the top of the list of search results. All of the other content items will appear below in descending order of weighting.

Weighting by content type

Content typeWeighting
User profile

1.5

Space1.5
Page1.5
Blog1.3
Attachment (files, videos and images)1
Comment1
Mail1

On Confluence, you're most likely to be searching for knowledge articles, work done by a particular team or person, or ways to collaborate. Our ranking logic prioritises content types such as user profiles, spaces, and pages that are most suitable for these tasks.

tip/resting Created with Sketch.

Simple example

If your search result returns 3 items – a page, a blog, and a comment – and they are the same in every other way, then they will be ranked in the order shown above.

Weighting based on field type

Field typeWeighting
Title2
Content1
Unstemmed title1
Label0

Search results that match the title field are twice as important and weighted twice as highly as matches in the body content.

tip/resting Created with Sketch.

Simple example

If you search for a user's name, the search results will rank the person's user profile above a page that only contains their name in the content. This is because the profile contains the name in the title field. This example assumes the results are the same in every other way.

Weighting based on recency

Last activityWeighting
Today2.01-2.05
Yesterday1.92-2.01
Up to 1 week ago1.52-1.92
Up to 1 month ago1.46-1.52
Up to 3 months ago1.36-1.46
Up to 6 months ago1.25-1.36
Up to 1 year ago1.11-1.25
Beyond a year1-1.11

Recency is based on when an item was created or last modified, whichever happened more recently. Search gives a higher weighting to recently updated items because it assumes this content is likely to be more relevant than idle or older content.

When a content item has not been modified in over a year, we say that it is in a state of "decay". In this state, we assume it is less relevant and it is de-prioritised in the search results in favour of content modified within the last year, and even more so within the last week.

tip/resting Created with Sketch.

Simple example

  • If two documents match in all other ways, then the newer one with be shown first.
  • If the two documents being compared are both older than a year then their relative age does not matter.


(info) Confluence uses the Apache Lucene search engine library. Lucene's score calculation has a number of additional terms, not mentioned in the above example. We have simplified the above explanation of search ranking for purposes of illustration. If you are interested, you can see more information in the Lucene documentation.

Last modified on Aug 22, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.