<!-- Source: https://docs.squirro.com/en/latest/technical/dashboards/types/global-search.html -->
# Global Search Dashboard

Squirro provides a uniform search experience for users via the _Global Search_ dashboard.

Once this feature is enabled, the search bar is integrated with the dashboard navigation on top of the screen.

This ensures it is always available to users to start a search.

## How to Enable Global Search

To enable this functionality, three steps are required:

1. Create a dashboard that provides the desired search behavior. The _Cognitive Search_ project template already includes such a dashboard.
2. Promote this dashboard to be the _Global Search_ dashboard on the project.
3. In the _App & Nav Bar_ configuration, enable the _Compact global search_ option.

The following sections explain these steps in more detail.

## Create the Dashboard

A typical global search dashboard will include some or all of the following components:

- _Items widget_ to show the result set.
- _Spelling Correction_ widget to guide the user when they mistype some words.
- _Question Answering_ widget to provide answers to questions.
- _Similar Searches_ widget.
- _Labels_ widget and _Timeline_ widget to help the user drill down in the result set.

## Promote the Dashboard

Once the dashboard has been created, go to the Dashboards list, and in the dashboard’s hover menu select `Promote Global Search`.

[![image1](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727673906/2727149807.png)](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727673906/2727149807.png)

> **Note**
>
> Only one dashboard can be the global search dashboard in a project. If another dashboard was configured as the global search dashboard it will be demoted.

If you would like to hide the dashboard which you have promoted as Global Search, from the Dashboard tabs, you can do this by unchecking its `Visible` property.

## Enable Compact Global Search

As a final step, navigate to the _App & Nav Bar_ section and enable the _Compact global search_ option.

[![image2](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727673906/2727641200.png)](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727673906/2727641200.png)

## End Result

With this done, the _Dashboards_ space will now show a search bar at the top at all times. This search bar will invoke the global search dashboard independent of which dashboard the user is currently on.

[![image3](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727673906/2726986073.png)](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727673906/2726986073.png)

The one exception to this is the [Community 360 Dashboard](community-360.md#dashboards-community-360), which by default stays on the dashboard but allows the user to switch to a project-wide search.

## Change Default Global Search Text

You can change the default text that appears in the global search bar in the Setup space.

To change the default global search text, follow the steps below:

1. Navigate to the Setup space.
2. Click the Settings tab.
3. Click Project Configuration from the left navigation bar.

[![Project Settings Config](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/gs-config.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/gs-config.png)

1. Find the `frontend.userapp.globalsearch-labels` setting.

[![Project Settings Configuration Edit](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/gs-config-text.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/gs-config-text.png)

1. Hover over the setting and click the Edit icon.
2. Change the appropriate text on the right side of the configuration screen.

[![Edit Global Search Placeholder Text Configuration Settings](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/gs-config-text-edit.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/gs-config-text-edit.png)
