> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.instabase.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.instabase.com/_mcp/server.

# Managing workspaces

> Create and configure shared workspaces, production flags, members, and roles.

Create shared workspaces, update settings, manage workspace members and roles, and designate production environments.

## Creating shared workspaces

Shared workspaces isolate projects and data and enable collaboration. Create them from **Settings** > **Workspaces**, then add members and assign workspace roles.

## Updating workspace settings

Learn about workspace settings and how to update them.

## Designating production workspaces

Mark a workspace as production when it holds operational workflows, so teams can keep development and production separate.

## Deleting workspaces

Deleting a workspace permanently removes its projects, runs, and related resources--use it only when that work is no longer needed.

## Changing members' workspace roles

Walk through updating a member's [workspace-level role](/admin/roles#workspace-roles) when their responsibilities change. Each workspace role includes all permissions from lower-level roles, plus additional capabilities. As a best practice, follow the principle of least privilege: assign the lowest role that still lets a member do their work, and grant a higher role only when their responsibilities require it.

> **Note**
>
> Roles are assigned on a workspace-by-workspace basis, meaning someone can have different roles across multiple workspaces.

## Removing members from workspaces

Remove someone from a workspace when they no longer need access there, without removing them from the organization.

## Related documentation

* [Managing workspaces](/admin/workspace-management)

* [Managing workspace members](/admin/workspace-members)

* [Organization and workspace roles](/admin/roles)