Teams

Overview

Teams let an account break its members into named sub-groups. When teams are enabled, task visibility for Admin users is scoped to their own team’s members, and regular members can view the full member list filtered to their team.

Requires: teams_enabled feature flag. The Teams nav item and all team functionality is hidden when the flag is off. When the flag is off, the whole account acts as one implicit team — all members can see all other members and all lists.

Permissions

Action	User	Admin / Team Admin	Root
View the Teams page	✓	✓	✓
View team members	✓ (all teams)	✓	✓
Create a team	✗	✓	✓
Rename a team	✗	✓	✓
Delete a team	✗	✓	✓
Add a member to a team	✗	✓	✓
Remove a member from a team	✗	✓	✓
Set team on a task list (own list)	✓	✓	✓
Set team on any task list	✗	✓	✓

Members with a custom role that includes team management access have the corresponding permissions.

How it works

Viewing teams

All members can see the Teams page and browse all teams and their members. Clicking a team card opens a read-only view of the team’s member list. Admin and Root additionally see Rename, Delete, and member management controls.

Creating a team

Admin and Root can create a new team from the Teams page. Members can be added immediately during the creation flow.

Team names are case-insensitive for uniqueness — “Team A”, “team a”, and “TEAM A” are all treated as the same name. If a name conflicts with an existing team the form will show an error before saving.

Adding members

Members can belong to multiple teams. The add-member picker shows all active members — adding the same member to the same team twice is prevented, but they can be on several teams simultaneously.

Members can also be assigned to a team at invite time — the Invite Member form includes an optional Team field when teams_enabled is on.

Team field on task lists

Every task list can optionally be associated with a team. The team is shown on list cards and in the list detail sidebar.

When creating a list:

If the creating member is on exactly one team, the list is automatically stamped with that team.
If the creating member is on multiple teams, a team picker appears in the create form so they can choose which team the list belongs to. Choosing “No team” is allowed.
If the creating member is on no team, the list has no team association.

When editing a list:

Admin and Root can change the team on any list they can manage.
A regular User can change the team only on lists they own, and only to teams they currently belong to.

When teams_enabled is off, the team picker, team badge on list cards, and team section in the detail sidebar are all hidden. Team associations are preserved and restored when the flag is re-enabled.

Task visibility when teams are enabled

When teams_enabled is on:

User: sees all lists associated with any of their teams, plus lists they created or are assigned to regardless of team.
Admin / Team Admin: sees lists associated with their teams and lists they created or are assigned to.
Root: sees all lists in the account (unchanged).

If a member creates a list while not on any team (or selects “No team” from the picker), the list has no team association and will only be visible to that member (and Root).

When teams_enabled is off, team associations are preserved but ignored — all members see all lists as before. Re-enabling the flag restores team-scoped visibility immediately.

Support notes

If a member is on multiple teams, the team picker appears in the create list form. If it is not showing, check that teams_enabled is on and the member has been added to more than one team.
If an Admin says they can’t see certain task lists after teams was enabled, check that those lists have a team association (visible in the list detail sidebar). Lists with no team association are only visible to the creator and Root.
If a member created lists before being assigned to a team, those lists will have no team association. An Admin or Root can open the list’s edit modal and assign it to a team.
Deleting a team does not delete its members or their tasks — it only removes the team and its memberships. Members become unassigned and can be added to another team.
To quickly identify which team(s) a member belongs to without opening the Teams page, check the Members page — each member card shows their team(s) when teams_enabled is on. See members.md for details.