> For the complete documentation index, see [llms.txt](https://docs.cipp.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cipp.app/user-documentation/shared-features/menu-bar/universal-search.md).

# Universal Search

Universal search finds records across every tenant you have access to from a single box, without switching tenant first. Search for a user by name and you get matches from all of your tenants at once, each labelled with the tenant it came from.

## Opening Search

Two icons in the menu bar open the search dialog, each starting on a different search type. The globe icon opens it ready to search users and entities, and the magnifying glass opens it ready to search CIPP's own pages. Once open, you can switch between any of the search types from the dropdown on the left.

| Shortcut             | Action                                   |
| -------------------- | ---------------------------------------- |
| Ctrl/Cmd + K         | Opens search on **Pages**.               |
| Ctrl/Cmd + Shift + F | Opens search on **Users**.               |
| Ctrl/Cmd + Alt + K   | Moves the cursor to the tenant selector. |

Where the navigation has collapsed behind the menu button, the two icons are not shown, and search is opened from the **Universal Search** entry in your account menu. It fills the screen, the search types are offered as chips beneath the box so any of them is one tap away, and the results appear in the page rather than in a dropdown. Before you have typed anything, your bookmarks are listed instead. See [Mobile Layout](/user-documentation/shared-features/mobile-layout.md).

## Search Types

| Type         | What is searched                                                                        | Selecting a result                                             |
| ------------ | --------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| Users        | User principal name or display name.                                                    | Opens that user in the tenant they belong to.                  |
| Groups       | Display name, with the group's mail address and description shown alongside each match. | Opens that group in the tenant it belongs to.                  |
| Applications | App registrations and enterprise applications, by name, application ID, or publisher.   | Opens the matching app registration or enterprise application. |
| Licences     | SKU ID, part number, licence name, or service plan.                                     | Opens a flyout with the full licence details.                  |
| BitLocker    | Recovery key ID or device ID, chosen from a second dropdown that appears for this type. | Opens a flyout with the recovery key details.                  |
| Pages        | Page names, tab names, paths, and whether a page is tenant-scoped or global.            | Navigates to that page.                                        |

The licence search returns a description, its service plans, and the tenants holding it, which is useful for identifying a licence when you only have a partial reference such as a SKU part number from elsewhere.

{% hint style="info" %}
The **Pages** search only returns pages your CIPP permissions allow you to open, so the results differ between users.
{% endhint %}

## Running a Search

For **Pages** and **Licences**, matches appear as you type, because both are matched against data already held in the browser.

For **Users**, **Groups**, **Applications** and **BitLocker**, type your terms and then press Enter or click **Search**. These types query across every tenant, so they run only when you ask rather than on each keystroke.

In the results list, matching text is shown in bold, and each result is labelled with the tenant it was found in. Use the up and down arrow keys to move through the list and Enter to open the highlighted result, or click it. Where nothing matches, the list reads **No results found**.

{% hint style="info" %}
Results for users, groups, applications and licences come from the CIPP reporting database, so they are only as current as the last cache run. A record created moments ago will not appear until the cache next refreshes. Licence searches are matched first against the Microsoft SKU catalogue built into CIPP, and fall back to cached data only when the catalogue has no match.
{% endhint %}

***

## Feature Requests / Ideas

We value your feedback and ideas. Please raise any [feature requests](https://github.com/CyberDrain/CIPP/issues/new?template=feature.yml) on GitHub.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cipp.app/user-documentation/shared-features/menu-bar/universal-search.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.