> 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/tenant-select.md). # Tenant Select The tenant selector sits at the top of CIPP and controls which tenant you are managing. Changing it reloads the data on the current page for the newly selected tenant, and cancels any requests still running for the previous one. ## Selecting a Tenant Tenants are listed as their display name followed by their default domain in brackets. Start typing to narrow the list by either part, then choose a tenant to switch to it. **\*All Tenants** is pinned to the top of the list. Selecting it shows data across every tenant you manage on pages that support it. Some pages behave differently under All Tenants, most notably tables, which always read from cached data in this mode. The tenant you are currently on stays in the list in its usual position, marked with a **Current** chip, and the list scrolls to it when you open the dropdown. The circular arrows button beside the selector reloads the tenant list. Use it when the list looks stale, for example after tenants have been added or removed since you opened CIPP. The selected tenant is reflected in the page address as a `tenantFilter` parameter, so any CIPP page can be linked to with a tenant already chosen. The parameter accepts the tenant's default domain, its initial `onmicrosoft.com` domain, or its tenant ID, and CIPP rewrites the address to the default domain once the page loads. {% hint style="info" %} Your selected tenant is remembered between sessions. If you open CIPP at a page with no tenant in its address, the tenant you last used is applied automatically. {% endhint %} ## Favourites and Recent Tenants The list is grouped, so the tenants you work with most sit at the top rather than buried in an alphabetical list of everything you manage. | Group | Description | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | **Favorites** | Tenants you have starred, in the order you starred them. | | **Recent** | The tenants you have selected most recently, newest first, up to eight. A tenant that is already a favourite is not repeated here. | | **All tenants** | Everything else, sorted alphabetically. | Each row carries a star on the right. Select it to add that tenant to **Favorites**, or select it again to remove it. Selecting the star does not change tenant, so you can reorganise the list without leaving the page you are on. Recent tenants are tracked for you: choosing a tenant from the dropdown adds it to the top of the group. **\*All Tenants** is excluded from both groups and cannot be starred, since it is already pinned above them. {% hint style="info" %} Favourites and recent tenants are stored in your browser rather than in your CIPP user settings. They are specific to the browser and device you set them on, they do not follow you to another machine, and clearing your browser's site data removes them. Both lists update immediately in any other CIPP tab you have open. {% endhint %} ## On Narrow Screens Where the window is too narrow for the selector, the menu bar shows the current tenant as a chip in its place. Selecting the chip opens a full-screen picker with its own search box and the same **All Tenants** entry, favourites, recent tenants and stars as the dropdown, so the same choices are available with more room to make them. Both forms read the same favourites and recent tenants, so resizing the window, or opening CIPP on a phone in a browser you have already used, keeps the groups you are used to. The tenant information flyout described below is not available from the picker. See [Mobile Layout](/user-documentation/shared-features/mobile-layout.md). ## Tenant Information The building icon to the left of the selector opens a flyout with details of the currently selected tenant, available from any page. It is unavailable while All Tenants is selected, and is not shown on narrow screens, where the selector is replaced by the tenant chip described above. | Field | Description | | ---------------------------------------- | ------------------------------------------------------------------------------- | | Display Name | The tenant's display name. | | ID | The tenant's directory ID. | | Street | The street recorded on the tenant's address. | | Postal Code | The postal code recorded on the tenant's address. | | Technical Notification Mails | The technical contact addresses Microsoft uses for service notifications. | | On Premises Sync Enabled | Whether directory synchronisation from on-premises Active Directory is enabled. | | On Premises Last Sync Date Time | When the directory last synchronised. | | On Premises Last Password Sync Date Time | When passwords last synchronised. | ## Portal Shortcuts The same flyout lists shortcuts for jumping straight to the tenant's Microsoft portals, each opening with the selected tenant already in context. | Action | Description | | --------------------- | ------------------------------------------------------------------------------------------------------ | | Manage Tenant | Opens the tenant's settings within CIPP. See [Edit Tenant](/user-documentation/tenant/manage/edit.md). | | M365 Admin Portal | Microsoft 365 admin center. | | Exchange Portal | Exchange admin center. | | Entra Portal | Microsoft Entra admin center. | | Teams Portal | Teams admin center. | | Azure Portal | Azure portal. | | Intune Portal | Microsoft Intune admin center. | | SharePoint Portal | SharePoint admin center. | | Security Portal | Microsoft Defender portal. | | Purview Portal | Microsoft Purview portal. | | Power Platform Portal | Power Platform admin center. | | Power BI Portal | Power BI admin portal. | Every portal other than **Manage Tenant** can be hidden from this list using the **Portal Links Configuration** settings described in [User Preferences](/user-documentation/shared-features/menu-bar/user-settings.md), so you can shorten it to the portals you actually use. *** ## 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/tenant-select.md?ask=&goal= ``` `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.