Help Center

Teams

Group workspace members and issues by team to improve focus and ownership.

What are teams?

Teams are named groups of workspace members. Assigning a team to an issue shows ownership and makes it easy to filter the board and backlog by team. Teams are an organisational grouping only — being on a team does not grant any additional permissions.

Teams are available on the Team plan.

Teams vs labels

Teams Labels
Purpose Ownership and grouping by team Lightweight tags for any category
Has members Yes — workspace members are added to a team No
Per issue One team per issue Multiple labels per issue
Best for Frontend, Backend, Design, QA Status, theme, area, release tag

Create a team

  1. Open Workspace Settings → Teams.
  2. Click Create team.
  3. Enter a name and optionally a color and description.
  4. Add workspace members to the team.
  5. Confirm — the team appears in the list.

Only members with the TEAMS_MANAGE permission can create and edit teams. By default this is OWNERs and ADMINs. See Permissions.

Edit and rename a team

  1. Open Workspace Settings → Teams.
  2. Click Edit next to the team.
  3. Update the name, color, description, or members.
  4. Save changes.

Add or remove members from a team

Team membership is separate from workspace membership. Removing someone from a team does not remove them from the workspace.

Add a member

  1. Open Workspace Settings → Teams.
  2. Click Edit next to the team.
  3. Select the member from the member picker and save.

Remove a member

  1. Open Workspace Settings → Teams.
  2. Click Edit next to the team.
  3. Click the remove icon next to the member and save.

Issues previously assigned to that team are unaffected — the team assignment on those issues remains unchanged.

Archive a team

Archiving a team hides it from active use but preserves all associated issue history. Archived teams cannot be assigned to new issues.

  1. Open Workspace Settings → Teams.
  2. Click Archive next to the team and confirm.

Issues already assigned to the archived team keep their team assignment. The team name remains visible on those issues for history.

Restore an archived team

  1. Open Workspace Settings → Teams.
  2. Scroll to the Archived teams section.
  3. Click Restore next to the team.

Assign a team to an issue

  • When creating an issue, select a team from the Team field.
  • On an existing issue, open the issue and click the Team field in the sidebar to change it.
  • One team can be assigned per issue.

Filter by team

  • On the board, use the team filter in the filter bar to show only issues belonging to a specific team.
  • On the backlog, use the team filter to narrow the issue list.
  • On the search page, filter results by one or more teams.

Teams and permissions

Teams are an organisational grouping only. Being a member of a team does not change what actions a user can take in the workspace. Permissions are controlled entirely by the workspace role (OWNER, ADMIN, MEMBER). See Permissions.