Marketplace search results and rankings


Making sure your add-on is discoverable in the Marketplace is important. This page outlines some basics about how the Marketplace rates and ranks search results. 

There are two key places that customers find your add-on in Atlassian Marketplace:

Marketplace homepage

The Marketplace homepage has several sections enabling customers to discover add-ons. By default the homepage includes add-ons across Atlassian products; customers can use the product selection on the sidebar to filter the homepage for a specific product. The homepage only includes add-ons from third-party vendors and excludes those published by Atlassian itself.

Explore add-ons

The Explore add-ons section at the top of the homepage includes six spots for add-ons—two each for JIRA and Confluence, one each for Bitbucket and HipChat. For each of the six add-on slots, a random add-on is chosen from the top 10 ranking add-ons for the given application. Since the selection is randomized, the add-ons displayed in this section will change each time the page is reloaded.

Add-ons are automatically ranked based on the following criteria:

  • Number of active installs
  • Star rating
  • Recency of publication

Additionally, the JIRA, Confluence and Bitbucket slots are limited to paid via Atlassian add-ons. This factor doesn't apply for HipChat add-ons.

Top-selling add-ons

The Top-selling add-ons section shows the top paid via Atlassian add-ons, sorted based on total dollar sales in the last 30 days.

Newest add-ons

The Newest add-ons section shows the most recently published add-ons, sorted based on their publication (approval) date. After your add-on is initially approved, publishing subsequent versions will not cause it to re-appear in the Newest add-ons list. The only exceptions are:

  • Publishing a paid version of a previously free add-on
  • Publishing a cloud version of a previously server-only add-on
  • Publishing a server version of a previously cloud-only add-on

Trending add-ons

The Trending add-ons section shows the add-ons that gained the most active installations in the past week. These add-ons are sorted by the difference between new customers added and existing customers who uninstalled the add-on.

Marketplace search results

On the Marketplace homepage, customers can search for add-ons using the large search bar at the top of the page. On other pages throughout Marketplace the search bar appears in the header.

How are search results ranked?

When a customer searches for add-ons, the results are ranked based on the relevance of the search term (if any), with the following serving as tiebreakers:

  • Number of active installs
  • Star rating
  • Recency of publication
  • Whether the add-on is paid via Atlassian

If the customer applies one of the on-page sorting options (top rated, top trending, top selling, newest), results are ranked first based on that sort, then by the relevancy of the search term (if any), and finally by the above tiebreakers.

How is search relevance determined?

Relevance is based on how well the search term matches the following add-on fields, in order of importance:

  1. Name
  2. Tagline
  3. Vendor name
  4. Category
  5. Highlights text (latest version)
  6. Compatible application name(s)
  7. Add-on key

Check out Build your presence on Marketplace to learn where these fields appear on your listing.

Was this page helpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport