Skip to main content
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.
Team-level roles are a feature of the Enterprise Edition. 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

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