Users can search the contents of your site in multiple ways. Depending on where the user searches, results can include:
Articles from Confluence spaces that are added to projects in native JSM as knowledge bases
Pages from Confluence spaces that you added to your Refined site
Jira Software issues
JSM request types
Navigation links (from the site's top menu)
Searching in modules
The Search Highlight module shows results based on its location.
Search highlight module placed on | Gives search results from |
|---|---|
The site’s home page | The entire site |
The landing page of a Confluence space or JSM project | Any sub-item grouped underneath that space or project in the Site Builder |
A Refined Page that uses modules to show content from a Jira Software project or Confluence space | Those projects or spaces |
A Refined Page page that doesn’t use modules to show content from a Jira Software project or Confluence space | The entire site |
When someone uses a search field on your site, the search results depend on:
Their Confluence and Jira permissions. Users can only see pages, blogs, requests and request types that they’re allowed to see in Confluence and Jira.
View permissions set up in the site structure. Apply view permissions on Refined pages, links, and menu folders in the site structure.
Search settings:
Promoted search results show at the top of the list of search results. They help users find content quicker by recommending pages to them when they search for specific keywords.
If you’ve narrowed down which Confluence pages and blog posts are included in the search results.
The type of search field they use. See the table below.
Search field in | Gives search results from |
|---|---|
Navigation menu (global search) |
|
Search Highlight module | Search results differ depending on the page the Search Highlight module is located on. |
Summary field when creating a JSM request | If your site features a knowledge base, users who create a JSM request |
...
see suggested |
...
articles based on their keywords when filling in the summary field. |
Searching via the navigation menu
Users search content from your entire site with the magnifying glass in the navigation menu.
Sidebar search in Confluence space
...
Left-hand menu of Confluence spaces | The search bar only gives results from the Confluence space it’s located in, including promoted search results. Toggle it on/off in the space settings. |
Search result overview
Users have various ways to specify what should be displayed in the search results.
Categories
If your site contains a variety of types of content, users can browse the search results by category:
| Expand | ||
|---|---|---|
| ||
The content is divided over these categories:
|
| Expand | ||
|---|---|---|
| ||
The content is divided over these categories:
|
| Expand | ||
|---|---|---|
| ||
The results aren’t divided over categories but shown in a list, ranked in this order:
|
Search location
Users can choose whether to search the entire site or a specific location.
Display options
Users can click the icons in the top right corner to choose to how to display the results (content or list view). The list view is more compact and doesn’t show include a text preview.
Content
List
Image and text
By default, the image and preview text of a search result are taken from the content of the page. You can customize the results by setting a custom featured image and text.