Teams

Overview

Teams group roles together and can be assigned to users, granting them all the permissions the included roles provide. By default, teams are managed in the Admin UI under Settings → Access Management → Teams. Like manually created roles, manually created teams live only in the database and must be recreated on each new environment.

TeamFactory is an extension that lets you define teams in code. Webiny loads them at boot time and merges them with database teams so they appear in the Admin UI like any other team. Because they come from code, they cannot be edited or deleted through the UI.

Creating the Extension

Teams reference roles by their slug. Define the required roles first — either in the Admin UI or via RoleFactory — then create a team extension that references them:

Then register it in webiny.config.tsx:

Team Properties

The roles array accepts role slugs — the same slug values defined in RoleFactory or visible in the Admin UI Roles module. A team can combine code-defined roles and roles created through the UI.

Defining Multiple Teams

A single execute() call can return multiple team definitions:

As with RoleFactory, you can also split teams across multiple extension files — each registered separately in webiny.config.tsx. Webiny merges all TeamFactory implementations automatically.