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

# Tenants

> The Platform surface for super admins to see and manage every tenant on the deployment, plus how to switch the tenant you're acting in.

**Tenants** is the cross-tenant management surface, found under **Settings › Platform › Tenants**. The **Platform** section of Settings is reserved for platform operators, so this page is effectively **Super Admin only** — it's gated on a capability that only that role holds.

<Note>
  A **tenant** is one isolated customer workspace: its own members, roles, groups, integrations, and policies. A **Tenant Admin** only ever sees their own tenant. A **Super Admin** operates across all of them, and this is where that happens.
</Note>

## The tenant list

The page lists every tenant on the deployment in a searchable, filterable table:

| Column           | What it shows                                      |
| ---------------- | -------------------------------------------------- |
| **Slug**         | The tenant's stable short identifier.              |
| **Name**         | The tenant's name.                                 |
| **Display name** | The friendly label shown in the UI (may be blank). |
| **Status**       | **Active** or **Disabled**.                        |

You can search by slug, name, or display name, and filter by status.

## Switching the tenant you're acting in

Cross-tenant admin work — managing [group mappings](/admins/access-control/group-mappings), [impersonating](/admins/access-control/impersonation) a user, and similar — lets a **Super Admin** choose which tenant the action applies to. That tenant picker lives with the surface you're using (for example, the toolbar on the Group mappings tab and the tenant filter in the impersonation popover), rather than as a single global switcher at the top of the app.

<Info>
  Verify before relying on it: the Tenants surface here is a management and provisioning view. Confirm the exact create/edit affordances against your deployment before documenting them for your team, as these controls are gated to platform operators.
</Info>