> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conduktor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Find resources and pages with global search

> Press Cmd+K or Ctrl+K in Conduktor Console to find topics, consumer groups, subjects, connectors, applications, users, groups and pages.

Global search finds topics, consumer groups, subjects, connectors, applications, users, groups and Console pages from one search box. It searches the current cluster or all your clusters, and only shows what you have permission to see.

Global search is available in Console v1.49.0 and later, and is on by default.

![Global search open over the Console home page, with a matching page under Go to and the matching resources below it](https://mintcdn.com/conduktor/rTpzK8Dz7ivlxp_j/images/global-search-results.png?fit=max\&auto=format\&n=rTpzK8Dz7ivlxp_j\&q=85\&s=b3da0ad6b408b4811551d0ad24405461)

## Open global search

Press **Cmd+K** on macOS or **Ctrl+K** on Windows and Linux, or click **Search** in the top bar. Both work on every Console page.

| Shortcut | Action |
| - | - |
| **Cmd+K** or **Ctrl+K** | Open global search on the current cluster. Press it again to close global search. |
| **Cmd+Shift+K** or **Ctrl+Shift+K** | Open global search on all clusters. When global search is open, switch between the current cluster and all clusters. |
| **Tab** and **Shift+Tab** | Move to the next or the previous filter. |
| **Up** and **Down** arrows | Move through the list. |
| **Enter** | Open the selected entry. |
| **Backspace** in an empty search box | Clear the filter. |
| **Esc** | Close global search. |

## Search for resources

Type at least three characters. The results update as you type and the first entry is selected, so you can press **Enter** to open it.

| Resource | Search matches on | Each result shows |
| - | - | - |
| Topics | Name | Number of partitions and messages |
| Consumer groups | Name | State and number of members |
| Subjects | Name | Latest version and schema type |
| Connectors | Name | Connector class and type, its state if it isn't running and the number of running or failed tasks |
| Applications | Name or title | Owner group and number of instances |
| Users | Name or email | Email |
| Groups | Name | Description, or the number of members if the group has no description |

Global search looks for the text you type anywhere in the name and ignores case. Searching for `ord` finds `orders`, `customer-orders` and `Payment-Orders`. It doesn't correct typos: `ordrs` doesn't find `orders`.

Console orders the results by how closely the name matches: names that equal your search come first, then names that start with it, then names that contain it.

The list shows up to 20 results across all resource types. If more resources match, a message under the list asks you to refine your search: type more of the name or select a [filter](#filter-by-resource-type).

Topics, consumer groups, subjects and connectors come from the metadata that [Console indexes](https://docs.conduktor.io/guide/conduktor-concepts/indexing.md) for each cluster, so a resource you just created can take a moment to appear.

To open a result, click it. You can also select it with the arrow keys and press **Enter**. Users and groups open in **Settings**. Applications open in the **Application Catalog**.

### Search one cluster or all clusters

**Cmd+K** or **Ctrl+K** searches the topics, consumer groups, subjects and connectors of the cluster that's selected in Console. To search every cluster you have access to, press **Cmd+Shift+K** or **Ctrl+Shift+K**. You can also click the cluster badge on the right of the search box. Do the same again to go back to the current cluster.

When you search all clusters, each of these results shows its cluster. If you open a result on another cluster, Console switches to that cluster first.

Applications, users and groups don't belong to a cluster, so global search finds them either way.

**Search** in the top bar opens global search on the scope you used last.

![Global search on all clusters, with the All clusters badge in the search box and a cluster badge on each topic and consumer group](https://mintcdn.com/conduktor/rTpzK8Dz7ivlxp_j/images/global-search-all-clusters.png?fit=max\&auto=format\&n=rTpzK8Dz7ivlxp_j\&q=85\&s=6df624092abe5564e34188c657d02633)

## Filter by resource type

Under the search box, select a filter to search one resource type: **All**, **Topic**, **Subject**, **Consumer group**, **Connector**, **Application**, **User** or **Group**. Click a filter, or press **Tab** and **Shift+Tab** to move through them. To go back to **All**, press **Backspace** in an empty search box.

### Start from the filter of the current page

Global search opens with the filter that fits the page you're on:

| Page you open global search from | Filter |
| - | - |
| **Topics**, or a topic | **Topic** |
| **Schema registry**, or a subject | **Subject** |
| **Consumer groups**, or a consumer group | **Consumer group** |
| **Kafka Connect**, or a connector | **Connector** |
| **Application Catalog**, or an application | **Application** |
| **Settings** > **Users**, or **My profile** | **User** |
| **Settings** > **Groups** | **Group** |
| Any other page | **All** |

![Global search opened from the Topics page, with the Topic filter selected and the Search topics placeholder](https://mintcdn.com/conduktor/rTpzK8Dz7ivlxp_j/images/global-search-topic-filter.png?fit=max\&auto=format\&n=rTpzK8Dz7ivlxp_j\&q=85\&s=e438ddcc0e6e53370fa4233f08fc56f0)

### Use type shortcuts

To select a filter from the keyboard, type its shortcut in an empty search box and press **Space**. Console selects the filter and clears the search box.

| Type this, then press **Space** | Filter |
| - | - |
| `t` | **Topic** |
| `s` | **Subject** |
| `c` | **Consumer group** |
| `k` | **Connector** |
| `a` | **Application** |
| `u` | **User** |
| `g` | **Group** |
| `go` | Pages only. See [go to a page](#go-to-a-page). |

Type shortcuts work when the filter is **All**, or is still the one global search opened with. Once you select a filter yourself, Console treats a letter followed by a space as part of your search. To use a shortcut again, press **Backspace** in an empty search box to clear the filter first.

## Go to a page

When the filter is **All**, the Console pages that match your search appear under **Go to**, above the resources. Pages match from the first character you type, and the list shows up to four of them.

A page matches when every word you type starts a word in its name or in one of its related terms. For example, `lag` finds **Consumer groups** and `rbac` finds **Groups**.

To see pages only, type `go` and press **Space**. Global search then lists every page you can open, grouped like the sidebar: **Console**, **Analytics**, **Governance** and **Settings**. Type to narrow the list. In this mode, global search doesn't look for resources.

Pages that belong to a cluster, such as **Topics** or **Brokers**, open on the cluster that's selected in Console.

To leave the page list, press **Tab** or press **Backspace** in an empty search box.

![The page list after typing go and Space, starting with the pages of the Console section](https://mintcdn.com/conduktor/rTpzK8Dz7ivlxp_j/images/global-search-pages.png?fit=max\&auto=format\&n=rTpzK8Dz7ivlxp_j\&q=85\&s=ee02ba593139769beb2bab8cdbe74e47)

## Reuse recent searches and recently viewed resources

When the search box is empty, global search lists your recent searches and the resources you viewed recently.

![Global search with an empty search box, showing Recent searches above Recently viewed](https://mintcdn.com/conduktor/rTpzK8Dz7ivlxp_j/images/global-search-recents.png?fit=max\&auto=format\&n=rTpzK8Dz7ivlxp_j\&q=85\&s=48c360b47772088e67e8c45aa2b1d09f)

### Recent searches

**Recent searches** lists your last five searches, newest first. Console saves a search when you open an entry from its results.

Select a recent search to run it again. To remove one, point to it and click **X**.

Console saves recent searches with your user preferences, so you get the same list in every browser you sign in from.

### Recently viewed

**Recently viewed** lists the topics, subjects, consumer groups and connectors you opened last, newest first. Console keeps up to five of each type for every cluster, and doesn't keep a history for applications, users or groups.

The list follows the filter and the cluster you search: when you search all clusters, it covers every cluster you have access to.

> [!NOTE]
>
> Console keeps the recently viewed history in the browser, not with your user account, so you don't get it in another browser or on another device. It stays in the browser after you sign out, but nobody else who signs in there sees it.
>
> The browser keeps one history at a time: when another user signs in to Console in the same browser and opens a topic, subject, consumer group or connector, their history replaces yours.
>
> Console doesn't show history saved by an earlier Console version, so the list can be empty after an upgrade.

## Understand what each user can find

Global search applies your permissions to every result, so two users can get different results for the same search.

| Result | You find it when |
| - | - |
| Topics, consumer groups, subjects and connectors | You have access to the cluster and permission to view the resource. |
| Applications | You have permission to view the application. |
| Users and groups | You have permission to view or manage Console users and groups (`userView` or `userManage`). |
| Pages | You can open the page from the sidebar or from **Settings**. |

Global search doesn't include topics that you can see in the Topic Catalog but don't have access to. To find and request access to those topics, [search the Topic Catalog](https://docs.conduktor.io/guide/use-cases/self-service.md#topic-catalog-page).

Find out how to [assign permissions with Role Based Access Control (RBAC)](https://docs.conduktor.io/guide/conduktor-in-production/admin/set-up-rbac.md).

## Configure global search

Global search is on by default. Administrators can turn it off, or change its timeouts, the number of searches it runs at the same time and the number of results it checks against permissions, with the [global search properties](https://docs.conduktor.io/guide/conduktor-in-production/deploy-artifacts/deploy-console/environment-variables.md#global-search-properties) in the Console configuration.

When global search is off, Console removes the **Search** button and the keyboard shortcuts.

## Troubleshoot

> [accordion] The Search button and the shortcuts don't appear
>
> Global search is off in the Console configuration, or Console is older than v1.49.0. Ask your administrator to check the [global search properties](https://docs.conduktor.io/guide/conduktor-in-production/deploy-artifacts/deploy-console/environment-variables.md#global-search-properties).

> [accordion] A resource you expect doesn't appear
>
> Check the following:
>
> * the filter and the cluster badge in the search box: a filter limits the results to one resource type, and **Cmd+K** or **Ctrl+K** searches the current cluster only
> * the spelling: global search looks for the exact text you type
> * your permissions: global search only shows the resources you have permission to view
> * how recent the resource is: topics, consumer groups, subjects and connectors appear once Console has indexed them

> [accordion] You get fewer results than you expect
>
> For each resource type, Console checks your permissions on a limited number of matches. If you only have access to a few of many matching resources, type more of the name to narrow the search.
>
> Administrators can raise this limit with the [global search properties](https://docs.conduktor.io/guide/conduktor-in-production/deploy-artifacts/deploy-console/environment-variables.md#global-search-properties).

> [accordion] Global search shows 'Search is unavailable right now'
>
> The search took too long, or Console couldn't complete it. It also appears when too many searches run at the same time, because Console limits how many it runs at once. Click **Try again**.
>
> If it keeps happening, ask your administrator to check the timeouts and the number of searches allowed at the same time in the [global search properties](https://docs.conduktor.io/guide/conduktor-in-production/deploy-artifacts/deploy-console/environment-variables.md#global-search-properties).

## Related resources

* [Assign permissions with RBAC](https://docs.conduktor.io/guide/conduktor-in-production/admin/set-up-rbac.md)
* [Find out how Console indexes Kafka metadata](https://docs.conduktor.io/guide/conduktor-concepts/indexing.md)
* [Find topics and applications with Self-service](https://docs.conduktor.io/guide/use-cases/self-service.md#self-service-ui)
* [Manage topics in Console](https://docs.conduktor.io/guide/manage-kafka/kafka-resources/topics.md)
* [Give us feedback/request a feature](https://conduktor.io/roadmap)&#x20;


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.