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

# Work across organizations

> Switch between the organizations in your tenant, and manage the tenant users who work across them, from the DFNS dashboard.

> [!NOTE]
>
> **Key Takeaways:**
>
> * A **tenant** groups your organizations. See [Tenants](https://docs.dfns.co/core-concepts/tenants.md).
> * **Tenant users** can access more than one organization and switch between them without a new passkey prompt.
> * The tenant **Team** manages tenant users; each organization's **Users** page manages that organization's own org users, end users, and service accounts.

This guide applies when your account has more than one organization under a tenant. If you operate a single organization, you will not see the tenant views described here. The tenant model is enabled per account by DFNS.

## Switch between organizations

Tenant users can move between the organizations they have access to:

1. Open the organization switcher at the top left, or **Organizations** in the tenant view.
2. Select the organization to sign in to it.

DFNS keeps the organization you came from signed in when you switch, so you can keep separate browser tabs open in different organizations at the same time. Every page is bookmarkable, because the organization is part of the URL.

![The organization switcher open, listing the organizations in the tenant](https://mintcdn.com/dfns-6d8c7466/fMmJfb_xLk1pbCcJ/images/auto/work-across-organizations-1.png?fit=max\&auto=format\&n=fMmJfb_xLk1pbCcJ\&q=85\&s=c5a304acac1aa85091a1e0474a1fb6ed)

## View your organizations

From the tenant view, open **Organizations** to see every organization in your tenant and jump into any of them.

![The tenant Organizations page showing the organizations in the tenant](https://mintcdn.com/dfns-6d8c7466/fMmJfb_xLk1pbCcJ/images/auto/work-across-organizations-2.png?fit=max\&auto=format\&n=fMmJfb_xLk1pbCcJ\&q=85\&s=cbc124f381b8980b346ac60198a09a4d)

## Create an organization

1. From the tenant view, open **Organizations** and click **New Organization**.
2. Enter a **Name** and pick the **Key store** that holds the organization's keys.
3. Click **Create**.

You become the first org admin of the new organization. Creating organizations needs the tenant permission to create organizations. If no key store is listed, contact our Support Team to have one assigned to your tenant.

## Suspend, archive, or restore an organization

From **Organizations**, open an organization's action menu (**⋮**):

* **Suspend**: everyone loses access to the organization and its API integrations stop working, until you restore it.
* **Archive**: everyone loses access, and its wallets, keys, and policies stop being usable. The dashboard asks you to confirm before archiving. Archived organizations move to the **Archived** view.
* **Restore**: brings a suspended or archived organization back to active.

Changing an organization's status needs the tenant permission to update organization status. See [Organization status](https://docs.dfns.co/core-concepts/organizations.md#organization-status).

## Manage tenant users (Team)

The tenant **Team** lists your tenant users, who belong to the tenant rather than to a single organization. From here you can:

* Invite a new tenant user.
* See which organizations each tenant user can reach, under **Org Access**.
* Remove a tenant user from every organization. To remove them from one organization only, delete them from that organization's **Users** page. Either removal is refused if it would leave the tenant or an organization without an admin, or a policy without enough approvers.

![The tenant Team page listing tenant users, their roles, and the organizations each can reach](https://mintcdn.com/dfns-6d8c7466/fMmJfb_xLk1pbCcJ/images/auto/work-across-organizations-3.png?fit=max\&auto=format\&n=fMmJfb_xLk1pbCcJ\&q=85\&s=9679727f5c1a6fe66e79ebbbe6cf3bc7)

> [!NOTE]
>
> Org users, end users, and service accounts are never tenant users. They belong to a single organization and are managed from that organization's **Users** page. See [Tenants](https://docs.dfns.co/core-concepts/tenants.md) for the full breakdown of who lives where.

## Grant an existing tenant user access to an organization

To let a tenant user into another organization:

1. Switch to the target organization.
2. Go to **Users** and click **Invite User**.
3. Choose **Tenant User** and enter the person's email address.
4. Click **Invite**.

They gain access to the organization immediately, with no registration email, and with no org permissions. Assign roles in that organization to grant them. See [Manage users and roles](https://docs.dfns.co/guides/users-and-roles.md).


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