Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

This functionality was previously called Recommended Links.

Use Promoted Search Results to improve your users' search experience. It lets you decide what pages are suggested to users Help users find content quicker by recommending pages to them when they search for specific key terms. This reduces the amount of time they have to spend looking through documentation.

Promoted Search Results can be used globally or contextually.

...

keywords. Promoted search results appear as “Recommended” at the top of

...

Contextually - for specific parts of a Refined site. For example, you can add Promoted Search Results to a JSM project.

...

the search results.

...

Promote a search result

  1. Head to the Refined Administration.

  2. Click Sites in the left-hand menu.

  3. Pick the site you want to work withSelect a site.

  4. Click on the Audience Features Search settings tab.

  5. Choose the page to which you’d like to add a Promoted Search ResultScroll down to Promoted search results.

  6. Click the + Create New button.

  7. Set up the linkpromoted search result.

Parameter

Setting

Description

Link URL

This can be any internal or external URL.

Link name

The link’s name that the user who is searching will see.

Choose icon

Add an icon to the promoted search result.

Match word

The link is suggested when a user searches for any of these key terms.
To add multiple match words, separate them with a comma.

Open in new window

Decide whether the link should open in the same window or a new one.

Pin link in Search Result

Pin a link in the search field, which is displayed when a search doesn’t
return any results, regardless of the match words.

See statistics

...

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.

...

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 links promoted search results that no longer serve their purpose.

To see the statistics, hover your mouse on the number of clicks.

...