Files
team/content/docs/account/organizations-workspaces.mdx
zeekay d02e5a72c6 docs: illustrate Hanzo Team as a full user manual with live screenshots
Embed 51 captured screenshots (27 desktop primary + 24 mobile) across 16
feature pages, add a top-level Full manual handbook TOC, and expand the
surrounding prose into step-by-step walkthroughs.

- getting-started: sign-in (email/Google/GitHub/Continue with Hanzo + hanzo.id
  SSO), workbench + app rail, 5-surface launcher, workspace settings
- account: org-grouped switcher, account menu, account settings, wallet +
  Developer/Pro/Plus/Max plans on billing.hanzo.ai, agents/bots as members + DM
- tracker: project navigator, New Issue dialog, issue detail, All Issues
- documents/drive/chat/planner/HR/contacts walkthroughs
- honest desktop-first note; HR (beta) empty state noted plainly
- assets under public/img/<feature>/<view>-<viewport>.png
2026-07-21 15:52:04 -07:00

78 lines
4.4 KiB
Plaintext

---
title: Organizations & workspaces
description: How organizations and workspaces relate, and how to switch between them.
---
Hanzo Team follows a Slack-style model for structuring teams: you sign in once with your Hanzo account and can belong to many places at once.
## The model
- **Organization** — the top-level container for a company or group. Billing, plan, and org-wide membership live here.
- **Workspace** — a space inside an organization that holds projects, documents, channels, and everything else. An organization can have several workspaces (for example, one per department or product).
- **Member** — a person, identified by their Hanzo account, who belongs to one or more workspaces with a [role](/docs/advanced-settings/roles) in each.
Your single Hanzo identity spans every organization and workspace you're part of — there are no separate logins to juggle.
## Switching
Use the **account switcher** at the top of the left sidebar to move between organizations and workspaces. Switching is instant and does not sign you out — your session carries across all of them, the same way you'd switch between Slack workspaces.
![Org-grouped workspace switcher (org heading over its workspaces, Create/Invite to workspace)](/img/shell/switcher-desktop.png)
*The switcher groups workspaces under their organization. Each org heads its own list of workspaces, with **Create workspace** and **Invite to workspace** below.*
A checkmark marks the workspace you're in now. Select any other workspace to jump straight to it, or use **Create workspace** to start a new one inside the same organization.
> **On mobile:** the switcher opens as a full-width sheet with the same org-grouped list.
![Org-grouped workspace switcher (org heading over its workspaces, Create/Invite to workspace) (mobile)](/img/shell/switcher-mobile.png)
*The workspace switcher on a phone.*
## The account menu
Your avatar at the bottom of the app rail opens the **account menu** — the hub for your identity, appearance, and the rest of Hanzo:
![Account menu: Profile, Theme (Light/Dark), Workspace settings, Usage & billing, Sign out](/img/shell/user-menu-desktop.png)
*The account menu: Profile, a Light/Dark theme toggle, Workspace settings, Usage & billing, the Surfaces launcher, and Sign out.*
- **Profile** — your name, avatar, and contact details.
- **Theme** — switch between Light and Dark.
- **Workspace settings** — jump into the workspace's configuration.
- **Usage & billing** — open your [wallet and plan](/docs/account/usage-billing).
- **Surfaces** — launch other Hanzo products (see [Learn the basics](/docs/getting-started/learn-the-basics#jump-to-other-hanzo-surfaces)).
- **Sign out** — end your session.
> **On mobile:** the account menu opens as a full-width sheet.
![Account menu: Profile, Theme (Light/Dark), Workspace settings, Usage & billing, Sign out (mobile)](/img/shell/user-menu-mobile.png)
*The account menu on mobile.*
## Account settings
Choose **Profile** (or the gear at the top right, then **Account settings**) to manage the parts of your Hanzo account that follow you into every workspace:
![Account settings (profile, password, integrations, notifications, calendar)](/img/settings/account-desktop.png)
*Account settings: your profile and password, plus Integrations, Notifications, Auto translation, Calendar, Office, and Mailboxes.*
These are personal to you — changing your notification preferences or connecting an integration here applies across the organizations and workspaces you belong to, not just the one you're viewing.
> **On mobile:** account settings scroll in a single column.
![Account settings (profile, password, integrations, notifications, calendar) (mobile)](/img/settings/account-mobile.png)
*Account settings on a phone.*
## Joining and leaving
- **Join** — open an invite link and sign in, or accept an invitation sent to your email. See [Workspace setup](/docs/getting-started/workspace-setup#invite-your-team).
- **Guests** — people outside your organization can be invited as guests to specific content without full membership.
- **Leave** — you can leave a workspace from the account switcher; an administrator can also remove members in **Settings → Members**.
## Administration
Workspace administrators manage members, roles, and enabled modules under **Settings**. Organization owners additionally manage the [plan and billing](/docs/account/usage-billing) that apply across the organization's workspaces.