Promoted search results

Help users find content quicker by recommending pages to them when they search for specific keywords. Promoted search results appear as “Recommended” at the top of the search results.

image-20240328-105852.png

Promote a search result

  1. Head to the Refined Administration.

  2. Click Sites in the left-hand menu.

  3. Select a site.

  4. Click the Search settings tab.

  5. Scroll down to Promoted search results.

  6. Click the + Create button.

  7. Set up the promoted search result.

Setting

Description

Setting

Description

Name

The promoted result’s name in the search dialog.

URL

Add https:// before a URL. You can also use relative links to direct users to pages on the site, for example /space/(spacekey) or /project/(projectkey).

Icon

Shown next to the promoted result’s name in the search dialog.

Scope

The result is always visible when searching via the search field in the site header or on the home page.

To show the result in all other searches too, add the site name as scope.

To show the result only in searches on specific locations on the site, add them as the scope.

Keyword

The search dialog shows the promoted result when a user uses any of these search terms. Simply type and hit enter to add keywords.

Open in new tab

Open the page in a new tab instead of the current tab.

Fallback result: promote when no results are found

Show this result when users search for a keyword that doesn’t give any results.

Edit or delete a promoted search result

  1. Click a result’s Cogwheel.

  2. Click Edit or Delete.

image-20240830-112339.png

See statistics

In the overview of promoted search results you can see how often each link is clicked. Hover the number to see when the result was clicked last. This helps you identify what your users are looking for, so you can delete the promoted search results that no longer serve their purpose.