Skip to content →

Teams

Create teams in your workspace to organize different types of work functions.

linear app showing teams page

Overview

By default, when you create a workspace we'll generate a team for you with the same name. It's up to you how to split up teams and you can be part of one or many teams. Here are different ways you can:

  • To group teammates who work together frequently.
  • To group an area of work such as marketing, mobile app, etc.
  • On small teams, it can help to keep everyone together to get the most out of features such as cycles.
If you aren't sure how to split up your teams, default to starting with fewer teams. It's easy to add more teams in the future and move issues from one team to another.

View your team(s)

Teams in which you are a member of will be listed in your sidebar. To join additional teams, navigate to the Teams view on your side bar.

Teams you navigate that you are not a member of will show up in your sidebar under a temporary "Exploring".

You can also search for teams quickly from the command bar Cmd/Ctrl + K.

Create a team

  • From the Teams view, click + Add team in the upper right.
  • In Settings below the list of existing Teams, click the + Add team.
  • From command bar Cmd/Ctrl + K, select Create new team.

During team creation, you'll have the option to copy over settings from an existing team and make the team private.

Team Limits

The number of teams that can be created is dependent on a workspace's subscription:

  • Free: Limited to 2 teams
  • Basic: Limited to 5 teams
  • Business: Unlimited teams
  • Enterprise: Unlimited teams

Team settings

Team settings allow you to configure each team differently to support different ways your teams work. The caveat is if there is a team setting in which you want a global setting, you have to adjust the setting for each individual team (unless you use the copy team settings options during team creation).

To access your team's settings, hover over the team name, click the three dots ··· menu, and select Team settings.

Some things to keep in mind when deciding how to structure your workspace's teams:

  • Issues are tied to teams. Think about how you prefer to manage your work and interact with features such as the backlog and archive.
  • Workflows can be customized per team. Different work areas or internal teams (e.g. engineering, design, marketing, sales) may require different statuses.
  • Cycles are team-specific. You can set them up so that all teams follow the same schedule, but you can't view more than one team's cycle at once. Think about how you manage your work, run meetings, measure progress, and how many cycles you'll want to oversee as a manager.
  • Projects can belong to a single team or be shared across many teams.
  • Sub-issues can be assigned to any team or member in the workspace, not just the parent issue's team.
  • Other features are team-specific but also easy to copy over to another team, such as pull request automation and issue templates. Labels are team-specific but you can create views that show issues from multiple teams as long as the label has the same name across them.

Team name and icon

On the General page of your team's settings, you can change the team's icon, customize the team name as well as the issue identifier from here also.

Changing the issue identifier is a safe action to take -- old URLs containing the original identifier will automatically redirect to the new issue URL.

Timezone

Timezone is set at the team-level and can be found on the General page of your team's settings.

Disable issue grouping history

By default, all updates to an issue from a member are grouped into one history entry when they occur within an hour. Turning on the toggle to enable this setting located in General will create a line item in an issue's Activity section for every action a member takes for that issue.

Make a team private

The General page of team setting allows you to convert a team to private.

Access control

All members of a workspace can view and join teams as long as the team is not private. Anyone in the workspace can create issues for other teams or be assigned issues in other teams, too. You don't have to join teams to collaborate with others unless you use them frequently and want them to show up in your sidebar.

Join / leave / invite

Admins can add users to a team in Settings > Team > Members. Members can join and leave teams on their own, by hovering over the team name, then clicking the ··· and selecting to Join team or Leave team... To join a private team, members must be invited by the team owner.

Delete a team

Deleting the team will also permanently delete any issues associated with it. This can't be undone and your data cannot be recovered by Linear. You will have 1 week grace period to restore the
team under Recently deleted teams. If you may need the data in the future, consider making the team private, leaving the team, exporting the issues or moving the issues to a different team.