> ## Documentation Index
> Fetch the complete documentation index at: https://formbricks.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams and roles

> Learn about team-level roles and workspace permissions that enable granular access control within teams and workspaces.

Team-level roles provide more granular permissions within specific teams and workspaces. These roles work alongside organization-level roles to create a flexible permission system.

> [!NOTE]
>
> Team-level roles are a feature of the [Enterprise Edition](https://formbricks.com/docs/self-hosting/advanced/license.md). In the Community Edition, all members are Organisation-level "Owners".

## Understanding the role hierarchy

Formbricks uses a two-tier permission system:

1. **Organization-level roles** - Apply across all teams and workspaces
2. **Team-level roles** - Apply within specific teams and workspaces

### How roles interact

* Organization-level roles (Owner, Manager) can override team-level restrictions
* Team-level roles provide granular control for specific teams
* Workspace permissions further refine what users can do within individual workspaces

Teams live under **Settings → Organization → Teams**, below the member list.

![The Teams card, listing each team and its size](https://mintcdn.com/formbricks/VfxKz9eund_LUynq/images/platform/features/user-management/teams-and-roles/teams.webp?fit=max\&auto=format\&n=VfxKz9eund_LUynq\&q=85\&s=fecd2b70d8fc5e8a4fab5fa492da986d)

## Team-level roles

### Team Admins

* Have additional permissions to manage their team's membership and workspaces
* Can add or remove team members
* Can create and manage workspaces within their team
* Can assign workspace-level permissions to team members
* These permissions are granted at the team-level and don't apply to teams where they're not a Team Admin

### Team Contributors

* Can view and act on surveys and responses within their assigned workspaces
* Cannot manage team membership or create new workspaces
* Permissions depend on their workspace-level access (Read, Read & Write, or Manage)

## Workspace-level permissions

A team is granted access to a workspace one workspace at a time, under **Settings → Workspace → Team Access**. The permission there decides what the team's members can do in that workspace.

![Team Access, showing each team's permission on this workspace](https://mintcdn.com/formbricks/VfxKz9eund_LUynq/images/platform/features/user-management/teams-and-roles/workspace-access.webp?fit=max\&auto=format\&n=VfxKz9eund_LUynq\&q=85\&s=cb61bc0ad8224a6d9ed643a642d43339)

Within each workspace, team members can have one of three permission levels:

### Read

* Read access to all resources (except settings) in the workspace
* Can view surveys, responses, and analytics
* Cannot create, edit, or delete surveys
* Cannot modify workspace settings

### Read & Write

* Read & write access to all resources (except settings) in the workspace
* Can create, edit, and delete surveys
* Can manage responses and tags
* Can download survey data
* Cannot modify workspace settings or manage integrations

### Manage

* Read & write access to all resources including settings in the workspace
* Full workspace control including settings
* Can manage API keys and integrations
* Can configure workspace-level settings like recontact options and styling
* Can manage workspace tags and actions

## Permission examples

### Scenario 1: Marketing Team Member

* **Organization role**: Member
* **Team role**: Team Contributor
* **Workspace permission**: Read & Write
* **Can do**: Create and edit surveys, view responses, download data
* **Cannot do**: Change workspace settings, manage team membership

### Scenario 2: Team Lead

* **Organization role**: Member
* **Team role**: Team Admin
* **Workspace permission**: Manage
* **Can do**: Everything within their team including managing members and workspace settings
* **Cannot do**: Access other teams, change organization settings

### Scenario 3: Department Manager

* **Organization role**: Manager
* **Team role**: N/A (org role overrides)
* **Workspace permission**: N/A (org role provides access)
* **Can do**: Access all teams and workspaces, manage organization membership
* **Cannot do**: Change organization-level settings like billing


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.