Switching Organizations

Learn how to efficiently switch between organizations and manage multi-organization workflows.

Organization Switcher

Accessing the Switcher

Sidebar Method

Click organization name in top-left sidebar
Dropdown shows all your organizations
Click desired organization
Context switches immediately

Keyboard Shortcut

Press Cmd + K (Mac) or Ctrl + K (Windows)
Type organization name
Press Enter to switch

Quick Switch

Recent organizations appear at top
Pinned organizations (starred) prioritized
Search by name or slug

Switcher Interface

┌─────────────────────────────┐
│ ACME Engineering       ✓    │  ← Current
├─────────────────────────────┤
│ ⭐ Client Alpha              │  ← Pinned
│ ⭐ Personal Projects         │  ← Pinned
├─────────────────────────────┤
│ Recent:                      │
│   Client Beta                │
│   Startup XYZ                │
├─────────────────────────────┤
│ All Organizations:           │
│   Client Gamma               │
│   Client Delta               │
│   + Create New Organization  │
└─────────────────────────────┘

Multi-Organization Workflows

Joining Multiple Organizations

You can be a member of multiple organizations:

Personal organization
Company organization
Client organizations (for agencies)
Open source projects

No limit on number of organizations you can join.

Organization Roles Per Context

Different roles in different organizations:

user@example.com
  ├── acme-engineering (Owner)
  ├── client-alpha (Admin)
  ├── personal-projects (Owner)
  └── open-source-team (Member)

Your permissions change based on current organization.

Context Switching

When you switch organizations:

✅ Active organization updates
✅ Navigation reflects new org
✅ Teams show current org teams
✅ Repositories show org repos
✅ Analytics show org data
✅ Settings show org settings
✅ Billing shows org billing

URL Updates

Before: app.mesrai.com/org/acme-engineering/teams
After:  app.mesrai.com/org/client-alpha/teams

Managing Multiple Organizations

Organization List

View all your organizations:

Go to Profile → Organizations
See list of all organizations
View your role in each
Quick actions per organization

Organization Card

┌─────────────────────────────┐
│ ACME Engineering            │
│ acme-engineering            │
│                             │
│ Your role: Owner            │
│ Members: 45                 │
│ Teams: 8                    │
│                             │
│ [Switch] [Settings] [Leave] │
└─────────────────────────────┘

Pinning Organizations

Pin frequently used organizations:

Hover over organization in switcher
Click star icon (⭐)
Organization moves to top
Appears in pinned section

Benefits

Quick access to important orgs
Persistent across sessions
Appear in quick switcher first

Recent Organizations

Automatically tracked:

Last 5 organizations visited
Sorted by most recent
Cleared on logout (optional)

Organization Favorites

Star important organizations:

Appears in favorites list
Quick filter in switcher
Sync across devices

Cross-Organization Features

Unified Search

Search across all organizations:

Press Cmd/Ctrl + K
Type search query
Results show from all orgs
Grouped by organization

Search: "backend team"

Results:
  ACME Engineering
    → Backend Team
    → Backend Repository

  Client Alpha
    → Backend Team
    → Backend API Docs

Global Notifications

Notifications from all organizations:

Unified notification center
Filtered by organization
Priority notifications highlighted

Filter Notifications

All organizations
Current organization only
Per organization settings

Cross-Organization Analytics

Compare performance across organizations:

Dashboard View

Organization       Reviews   Tokens    Members
──────────────────────────────────────────────
ACME Engineering   1,234     456K      45
Client Alpha       567       123K      12
Personal Projects  89        23K       3
──────────────────────────────────────────────
Total              1,890     602K      60

Organization Isolation

Data Isolation

Each organization has completely separate:

✅ Teams
✅ Repositories
✅ Members
✅ Analytics
✅ Billing
✅ Settings
✅ API Keys

No data sharing between organizations by default.

Billing Isolation

Separate billing per organization:

Independent subscriptions
Different payment methods
Separate invoices
Individual usage tracking

Access Isolation

Permissions don’t carry over:

Owner in one org ≠ Owner in another
Member lists are separate
Repository access is org-specific

Switching Best Practices

1. Clear Organization Names

Use descriptive names:

✅ acme-engineering - Clear
✅ client-alpha-project - Descriptive
❌ org1 - Unclear
❌ test - Ambiguous

2. Pin Frequent Organizations

Pin daily-use organizations:

Main work organization
Personal projects
Active client projects

3. Verify Context Before Actions

Always check current organization before:

Inviting members
Connecting repositories
Changing settings
Making billing changes

Visual Indicator Organization name always visible in:

Header bar
Sidebar
Page title
URL

4. Use Keyboard Shortcuts

Faster switching:

Cmd/Ctrl + K → Open switcher
Type org name
Enter to switch
Arrow keys to navigate

5. Organize by Purpose

Group organizations logically:

Work organizations (pin)
Client organizations (recent)
Personal projects (favorites)
Test/experimental (unpin)

Troubleshooting

Can’t See Organization

Problem: Organization not appearing in switcher

Solutions:

Verify you’re a member
Check invitation status
Ensure organization not deleted
Refresh page / re-login
Contact organization owner

Wrong Organization Context

Problem: Seeing wrong organization data

Solutions:

Check current organization in header
Use switcher to change organization
Clear browser cache
Verify URL includes correct org slug

Switching Not Working

Problem: Can’t switch between organizations

Solutions:

Refresh page
Clear browser cache
Check network connection
Try keyboard shortcut
Re-login to account

Lost After Switching

Problem: Navigation confusing after switch

Solutions:

Check breadcrumbs for current location
Use sidebar navigation
Return to organization home
Verify organization in header

Keyboard Shortcuts

Shortcut	Action
`Cmd/Ctrl + K`	Open organization switcher
`Cmd/Ctrl + Shift + O`	Quick switch to recent org
`Cmd/Ctrl + Shift + N`	Create new organization
Arrow keys	Navigate organizations in switcher
Enter	Switch to selected organization
Esc	Close switcher

Mobile App Switching

Mobile Switcher

Access on mobile:

Tap hamburger menu (☰)
Tap organization name
Select from list
Swipe to switch

Swipe Gesture

Swipe right on navigation → Previous org
Swipe left on navigation → Next org
Swipe down → Organization switcher

Mobile Organization List

View all organizations:

Tap Profile
Tap Organizations
See full list with details

API Integration

Get User Organizations

GET /v1/user/organizations
 
Response:
{
  "organizations": [
    {
      "id": "org_abc123",
      "name": "acme-engineering",
      "displayName": "ACME Engineering",
      "role": "OWNER",
      "isPinned": true
    }
  ]
}

Switch Organization Context

POST /v1/user/context
{
  "organizationId": "org_abc123"
}
 
Response:
{
  "currentOrganization": {
    "id": "org_abc123",
    "name": "acme-engineering"
  }
}

Pin Organization

POST /v1/user/organizations/{orgId}/pin
 
Response:
{
  "isPinned": true
}

Next Steps

Support

Need help switching organizations?

Organization Settings Organization Billing