> ## 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](/self-hosting/advanced/license). In the Community Edition, all members are Organisation-level "Owners".
</Note>

## 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

## 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

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
