Lesson 4 of 5 · 3 min

Switching Workspaces and Organizations

Understand how the Organization Switcher works when you belong to more than one workspace, and what changes when you switch.

Switching Workspaces and Organizations

Video coming soon

4/5

Lesson Notes

01

A single Vremly account can belong to multiple organizations — for example, a photographer who works for two media companies, or a real estate agent who is a customer of two different media providers. The active organization determines what data you see: your dashboard, projects, calendar, team, and invoices are all scoped to the currently selected org. The Organization Switcher sits in the top-left of the header on every page and shows the current org's logo and name.

02

To switch, click the org logo/name in the header to open the Organization Switcher dropdown. It lists every organization your account belongs to. Click the one you want to switch to. On switch, Vremly clears all cached query data (to avoid stale data from the previous workspace bleeding in) and reloads the dashboard in the context of the new org. The URL does not change — the org context is stored in a session variable, so if you reload the page you stay in the same workspace.

03

On iOS, the equivalent is the OrganizationSwitcherSheet, accessible by tapping your avatar in the top-bar or via a workspace icon in the navigation. After selecting a different org, the entire app's NavigationStack resets to the root dashboard so you start fresh in the new workspace. Any deeply-nested detail view from the previous org would be irrelevant in the new one, which is why the reset is intentional.

04

If your company admin sent you an invite to join a new organization, accepting the invite (via the /invite/[token] link in the email) will add the org to your switcher list automatically. You do not need to re-sign in or create a new account.

Key Takeaways

  • One account can belong to multiple organizations; the active org scopes all data you see.
  • Use the Organization Switcher (top-left header) to change workspaces — data reloads automatically.
  • Accepting an invite link adds the new org to your switcher list without creating a new account.
  • On iOS, a workspace switch resets the navigation stack to the dashboard root.
Related documentation at docs.vremly.com