---
id: SCR-PFM-CSH-006
title: Workspace switcher
route: (the header of every workspace page)
surface: console
product_area: platform
module: console-shell
revision: 1
status: draft
design_intent: confirmed
origin: >-
  react-console:docs/url-architecture.md#6. Tenant from the URL (decided by
  Andrew 2026-10-14; final acceptance 2026-10-15)
implementation_evidence: observed
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
purpose: >-
  The switcher identifies the workspace and customer currently held by the
  console and offers other reachable workspaces.
supports:
  - JNY-PFM-CSH-004
  - CAP-PFM-CSH-011
permission: platform.security-self.read
entry_from:
  - Console frame header (workspace mode)
exits_to:
  - The same area and list in the chosen workspace
inference: []
displays:
  - field: Selected workspace and customer details
    source: DOM-PFM-CSH-001 working context
  - field: Reachable workspace choices and optional search
    source: DOM-PFM-CSH-001 reachable workspaces (getMySecurityContext)
  - field: Entry activity indicator
    source: DOM-PFM-CSH-001 switching
actions:
  - label: Choose a workspace
    operation_id: 'getMySecurityContext (strict, through workspace entry)'
    permission: platform.security-self.read
    confirm: false
  - label: Copy identifier
    operation_id: 'none: clipboard'
    permission: platform.security-self.read
    confirm: false
states:
  - one reachable workspace
  - multiple reachable workspaces
  - workspace search without matches
  - entry busy with choices disabled
validation:
  - BR-CAP-PFM-CSH-011-01
  - BR-CAP-PFM-CSH-011-02
  - BR-CAP-PFM-CSH-011-03
  - BR-CAP-PFM-CSH-011-04
  - BR-CAP-PFM-CSH-011-05
  - BR-CAP-PFM-CSH-011-06
patterns:
  - Design-system Popover with search field
  - Copy control with confirmation toast
component: components/console/tenant-switcher.tsx
evidence:
  - >-
    react-console at baf6dae: components/console/tenant-switcher.tsx;
    lib/routes/match.ts:switchTenantPath.
controls: [TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-IAM-001, TC-IAM-002, TC-IAM-003, TC-IAM-004, TC-IAM-005, TC-LOG-001, TC-LOG-004, TC-LOG-005, TC-PI-001, TC-PI-003, TC-PI-005, TC-PRV-001, TC-PRV-002, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---
# Workspace switcher

## What the Screen Is For

The switcher identifies the workspace and customer currently held by the console and offers other reachable workspaces. It supports continuing the same kind of work in another organization.

## What It Shows and Lets People Do

The popover shows names and copy controls for customer and workspace identifiers. It offers choices when more than one workspace is reachable and adds name-or-identifier search above six. Choosing a different workspace changes the address, preserving the area and list while dropping record identities and the query.

## States and Errors

During entry, the switcher shows progress and disables choices. A no-match search explains the empty result. The success toast occurs before the strict entry request finishes, so a refusal can follow a success message.

## Patterns It Must Respect

The built Popover and copy-control toast are the patterns in use. Copy acknowledgement does not wait for clipboard success. Destination authority is resolved by workspace entry.