Workspaces & org scope

Catalog is multi-tenant. Almost everything you see — shows, collections, the import wizard’s target, proposal affordances — is scoped to one organization at a time. This page covers how to pick which org you’re in, how that choice flows through the rest of the app, and what’s special about the admin “All Shows” view.

Where to find the switcher

The org switcher lives in the top bar next to the Frequency wordmark. It shows the current org name and opens a dropdown of every org you’re a member of.

What an org actually changes

Switching workspaces re-scopes every list view in the app:

• Shows grid filters to that org’s inventory (agencies see shows their advertisers buy from; networks see shows they publish).
• Collections sidebar shows that org’s collections and that org’s folder tree.
• Import wizard writes new shows into that org.
• Proposal request affordances only appear when the active org is Frequency PPN.
• Admin views (“All Shows”, admin dashboard) are unaffected — they’re cross-org by design.

The org choice persists across page reloads and browser tabs. If you log out and back in, you land in the same workspace.

URL-prefixed workspaces

Most routes can carry the org slug in the URL — for example:

/acme-audio/collections/2024-q1-tech-pitches
/acme-audio/shows/morning-brief

If you open a URL like that and your switcher was on a different org, Catalog detects the slug, switches you to that org automatically, and shows a “Switched default workspace” toast.

This lets teammates deep-link each other to anything in any org they share access to without explanation.

Static segments aren’t org slugs

A handful of top-level URL segments are reserved and never treated as org slugs:

browse, collections, shared, shows, admin, settings, auth, api, personal

You’ll see these in URLs like /collections, /shared/<token>, /admin/all-shows — they apply across all orgs you can see.

Switching: what happens to the URL

When you pick a different org from the dropdown while you’re on an org-prefixed page:

1. Catalog swaps the slug in the URL so you end up on the equivalent page in the new org.
2. Detail slugs are dropped. A path like /acme-audio/collections/q1-pitches becomes /<new-org>/collections — the collection wouldn’t exist under the new org, so we land you on the listing instead.
3. If there’s nothing to swap (e.g. you’re on /settings), the URL stays put and only the scope changes.

Personal scope

Some surfaces live outside any org:

• Personal collections at /personal/collections/... — visible only to the creator, and they follow you across orgs.
• Account settings at /settings — your own preferences.
• Favorites — your favorited collections and shows, also cross-org.

These don’t change when you flip the switcher.

Admin: the All Shows view

Admins get a sidebar item under Admin → All Shows that opens the shows grid with no org scope — every show in every org, in one table.

This view bypasses the org switcher entirely; it’s intended for ops work (auditing, cleanup, cross-network reporting). The switcher in the header is also free to pick a “real” org — switching to one from All Shows lands you in normal scoped mode.

Edge cases & gotchas

• No orgs at all? Newly-created accounts with no memberships fall through to the pending-access page. Even admins need at least one org listed (admins automatically see every org).
• Mid-switch URL flicker — for one frame after picking a new org, the URL may still show the old slug. Catalog gates the sync so the switcher doesn’t snap back; if you see a brief flash, that’s why.
• Deep-link to a collection in a different org — Catalog will switch you to that org first, then open the collection. The toast confirms the switch.
• Single-org users — the switcher is still shown but only has one option; the AI assistant suppresses its scope banner in this case since there’s nowhere meaningful to switch to.