> For the complete documentation index, see [llms.txt](https://docs.intuneassistant.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intuneassistant.cloud/extensions/msp-support/switch-tenants.md).

# Switch Tenants

Muti-Tenant Management (MSP)

## Switch Tenants

How to switch between customer tenants in your MSP multi-tenant environment

[Switch Tenants](#switch-tenants)

Learn how to quickly switch between customer tenants in your MSP environment to manage multiple customer environments from a single interface.

### Overview

The tenant switching functionality allows MSPs to seamlessly move between different customer environments without losing context or requiring separate logins. This streamlines your workflow when managing multiple customer tenants.

### Switch with the customer switcher

The fastest way is the **customer switcher** in the top bar, which is always visible while you are signed in as an MSP.

1. Click the switcher at the top left. It shows the customer you are working in (name and domain) and a **Managed tenant** label.
2. Type to search. Customers you used recently are listed first.
3. Pick a customer. You stay on the page you were on and its data reloads for the new customer. If you were looking at one specific item (for example one device), you go back to that page's list, because the item belongs to the previous customer.
4. To leave a customer, choose **Back to my own tenant** at the top of the list. Nothing else closes the customer context, so you cannot leave it by accident.

While you work in a managed tenant the top bar has an amber edge and the label **Managed tenant**. The confirmation of actions that change something (migrate, restore, bulk edit, delete) names the customer it will run in.

Each browser tab has its own customer. You can work in two customers side by side in two tabs, and a refresh keeps the customer. The address carries it as `?tenant=<tenant id>`: send that link to a colleague and it opens the same customer, also after they sign in. A link to a customer that is not in their list, or that is no longer active, opens their own tenant with a message. A new tab starts in the customer you used last.

The other way, from the Customer page, is described below.

### How to Switch Tenants from the Customer Page

{% stepper %}
{% step %}

### Step 1: Navigate to Customer Settings

* Access your MSP home tenant
  * Ensure you're logged into your primary MSP account
  * Navigate to the main dashboard
* Go to Customer Settings
  * Click on **Customer Settings** in your MSP account menu
  * This displays all your managed customer tenants
    {% endstep %}

{% step %}

### Step 2: Select Target Tenant

* Locate the customer tenant
  * Browse through your list of managed customer tenants
  * Find the tenant you want to switch to
* Access tenant actions
  * Click on the **Actions** button in the tenant row
  * This opens the available actions for that specific tenant
    {% endstep %}

{% step %}

### Step 3: Switch to Tenant

* Click "Select Tenant"
  * From the actions menu, click **Select Tenant**
  * The system will initiate the tenant switch process
* Automatic context switch
  * The interface automatically updates to show the selected tenant
  * All subsequent operations will be performed in the selected tenant context

Quick Switch

That's it! You're now working in the selected customer tenant environment with all the appropriate GDAP permissions applied.
{% endstep %}
{% endstepper %}

### What Happens During Tenant Switch

#### Authentication Context

* **GDAP authentication** is applied for the selected tenant
* **Delegated permissions** are activated automatically
* **User context** is maintained throughout the switch

#### Interface Updates

* **Customer switcher** in the top bar shows the current active tenant
* **Data context** switches to the selected tenant
* **Navigation menus** reflect tenant-specific options

#### Permission Application

* **Role-based access** is applied based on GDAP configuration
* **Scope limitations** are enforced automatically
* **Audit trail** records the tenant switch activity

### Current Tenant Indicator

After switching tenants, you can identify your current context through:

* **Tenant name** displayed in the interface header
* **Tenant-specific branding** if configured
* **Context indicators** throughout the interface
* **Breadcrumb navigation** showing current tenant

### Best Practices

#### Before Switching

* **Complete current operations** in the active tenant
* **Save any pending changes** to avoid data loss
* **Note the target tenant** to ensure correct selection

#### During Operations

* **Verify tenant context** before making changes
* **Use tenant indicators** to confirm active environment
* **Be mindful of cross-tenant operations**

#### Security Considerations

* **Verify permissions** in the new tenant context
* **Check GDAP status** if access issues occur
* **Log out completely** when finishing work

### Switching Back to Home Tenant

To return to your MSP home tenant, open the customer switcher in the top bar and choose **Back to my own tenant**.

### Troubleshooting

<details>

<summary>Cannot Switch to Tenant</summary>

Possible causes:

* GDAP relationship expired or revoked
* Customer disabled delegated access
* Network connectivity issues

Solutions:

* Check GDAP status in Partner Center
* Contact customer to verify permissions
* Refresh the page and try again

</details>

<details>

<summary>Tenant Not Responding</summary>

Possible causes:

* Tenant-specific service issues
* GDAP permission synchronization delay
* Network or authentication problems

Solutions:

* Wait a few minutes and retry
* Check Microsoft service health
* Verify internet connectivity

</details>

<details>

<summary>Wrong Tenant Context</summary>

If you're in the wrong tenant:

* Immediately stop any operations
* Switch to the correct tenant using the same process
* Verify current context before proceeding

Double-Check Context

Always verify you're in the correct tenant context before making any configuration changes. Operations in the wrong tenant can affect the wrong customer environment.

</details>

### Keyboard Shortcuts

Some common shortcuts to improve efficiency:

* **Quick customer search** - Type in the customer switcher
* **Recently accessed** - The customers you used most recently are listed first

### Related Documentation

* [Add Tenant](broken://pages/b1de3e1808839ff9ac2a87daf5ab456639ef0d7b)
* [Multi-Tenant Overview](broken://pages/073f704ad110bef47686f7a9cb4cfa97aa5674b8)
* [GDAP Management](broken://pages/b00b4a4f7483488cbc56226800581a2d63f2608f)
* [MSP Best Practices](broken://pages/eb9c7c75814478d68771508fa6fe948d3cdc1f7e)

Efficiency Tip

Organize your customer list by priority or frequency of access to make tenant switching faster and more efficient.

[License Management\
\
How to add and remove licenses for customer tenants in your MSP environment](https://docs.intuneassistant.cloud/extensions/msp-support/license-management.md) [Add Tenant\
\
Step-by-step guide for adding customer tenants to your MSP home tenant](https://docs.intuneassistant.cloud/extensions/msp-support/tenant-management.md)
