Managing workspaces

A shared workspace is a workspace that multiple members of an organization can access. While every organization member has a personal workspace, shared workspaces are ideal for sharing access to resources within a workspace and collaborating on projects. All members of a shared workspace can:

• Access the input files stored on drives connected to that workspace when running an app.

• View all app run results for apps run within the workspace.

• Open and edit any Build projects created in the workspace.

• Move projects in the workspace to another workspace to which they have access.

Organization admins and workspace managers can manage shared workspaces from the Workspaces tab of the Settings page. To change between workspaces, use the workspace switcher dropdown.

Add shared workspaces

Organization admins can create shared workspaces. To add a shared workspace:

1. Do one of the following:

   • On the Settings page, select the Workspaces tab, then click Add new workspace.

   • On the My Hub tab, click the + icon next to the Workspaces heading.

2. In the Workspace name field, name the workspace. Workspace names can’t include spaces, but can include dashes and underscores, along with alphanumeric characters.

3. Click Create. An Add members dialog displays.

4. In the Managers field, enter the email of users to assign as workspace managers.

   Note

   By default, all organization admins are added to the workspace and have workspace manager permissions. Only non-admins can be assigned as workspace managers.

5. In the Users field, enter the email of users to add as workspace members.

6. Click Create.

Manage workspace members

Workspace managers and organization admins can add workspace members and manage their user roles. Members of a shared workspace can have one of the following user roles:

• User: Workspace users can access the workspace they’re a member of, including all files in drives connected to the workspace. Users have no administrative access.

• Manager: Workspace managers can add and remove workspace members and manage drives connected to the workspace they manage, but can’t add or delete workspaces. Only organization admins can assign the workspace manager role.

• Admin: By default, organization admins are also a workspace manager for all organization workspaces, with the ability to access, add, remove, and manage users for organization workspaces. Organization admins are assigned at the organization level.

Add members

To add members to a shared workspace:

1. Do one of the following:

   • On the Settings page, select the Workspaces tab, then select the workspace.

   • On the My Hub tab, select the workspace, then click the + icon in the Info section.

2. Click + Add members.

3. In either the Managers or Users field, enter the email of users to add to the workspace.

4. Click Add members.

Assign workspace managers

To make a workspace member a workspace manager:

1. On the Workspaces tab of the Settings page, select the workspace.

2. In the member’s row of the Members list, click the Edit icon.

3. Select the Manager role from the Role field.

4. Click Save.

Remove members

To remove members from a shared workspace:

1. On the Workspaces tab of the Settings page, select the workspace.

2. In the member’s row of the Members list, click the Delete (trash can) icon.

3. Click Confirm.

Manage workspace storage

See the connect drives documentation for guidance on connecting workspace-level drives, organization-level drives, and assigning default drives at the workspace or organization level.

Delete a workspace

Deleting a shared workspace permanently deletes all projects and app runs tied to the workspace and any connected drives are disconnected. Members of the workspace lose access to all work created in the workspace.

To delete a workspace:

1. On the Workspaces tab of the Settings page, select the workspace.

2. Click the three-dot icon.

3. Click Delete workspace.

4. Click Delete.