Browse all guides

Workspaces, projects, and access

Workspaces contain shared administration: members, projects, Notes, Agent Connections, messages, usage, and billing. Projects contain delivery work and can have a narrower team than the workspace.

Workspace membership and project membership are independent. A project-only collaborator sees the workspace name and projects explicitly shared with them, but not the workspace Team, Notes, billing, settings, analytics, Agent Connections, or unrelated projects.

When you invite a team member, you can select projects for each invite separately. Use Select all projects to include every active workspace project, including projects hidden by the current search. Use Clear project selection to remove every project from that invite. An empty selection still grants workspace access only. CSV invites do not include project assignments.

Workspaces can also show an icon in the dashboard selector and workspace header. Owners and administrators can upload or remove it in Workspace Settings. The icon is a public static image, so do not upload private content. Use a PNG, JPEG, or WebP image no larger than 2 MB. Project-only collaborators can see the workspace icon with the workspace name, but they cannot change it.

Workspace owners and administrators can discover active projects in their workspace. Other users see projects where they have a project membership. Project roles are:

  • Owner: full project control.
  • Admin: project administration and shared-content changes.
  • Member: normal collaboration and delivery changes.
  • Viewer: read-only access, with narrowly scoped personal actions such as recording read state.

The dashboard workspace and project selectors are navigation context. Personal surfaces such as My Work and Messages may span multiple workspaces. Messages labels each conversation with its originating workspace because the same two people can have distinct threads in different workspaces.

On desktop, the expanded sidebar shows a workspace menu, a settings cog, and a separate Home link. The cog sits immediately left of Home. Users with workspace access see both links. Project-only collaborators do not. The collapsed sidebar uses the workspace icon as the Home link and places a small switch control on the icon. On mobile, the workspace menu stays available in the drawer. Workspace Settings applies its own permissions to changes.

Hover over a project icon or focus its link with the keyboard to see the full project name.

Access changes are server-enforced. Hiding a control is useful guidance, but it is never the authorization boundary. When access is removed, stale dashboard selections are cleared and inaccessible routes return the user to an accessible workspace or setup state.

Updated 2026-10-08. Owned by product.