Users can search the contents of your site in multiple ways:
...
The Search Highlight module shows results based on its location.
If the module is placed on a parent page in the Site Builder hierarchy, it gives search results from any child content or item.
If the module is placed on a Refined Page that is connected to a Jira Software project or Confluence space, it also gives results from these projects or spaces.
If the module is placed on a page that doesn’t have a Confluence space, Jira Software project or JSM project associated with it, the module shows search results from your entire site.
...
Users access the global search by clicking the magnifying glass at the top-right corner of your site. The search results cover content from your 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. | |
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
...
Depending on where the user searches, results can include:
...
Articles from knowledge base spaces (shown via the JSM Knowledge Base setup)
...
Pages from Confluence spaces (shown via Refined for Confluence Cloud when a Confluence space has been added to a Refined site).
...
Jira Software issues
...
JSM request types
...
Navigation links (from the site's top menu)
...
.
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.