Teams

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

Overview⁠

Your workspace is organized into different teams. 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 users can be part of one or many teams.

Consider grouping teams by:

• Teammates who work together frequently.
• Areas of work such as marketing, mobile app, etc.
• Keeping everyone on one team is the simplest approach (best for small teams)

If you aren't sure how to split up your teams, start with one or two. It's easy to add more teams in the future, copy settings from existing teams, and move issues from one team to another.

Your teams⁠

Teams you have joined will appear in your sidebar.

Each team has the following pages to organize your work:

• Triage* Newly created issues to be reviewed, assigned or prioritized before entering the team's workflow
• Issues Default views of all issues in this team
• Cycles* Review current, past and upcoming cycles to plan and schedule your team's workload
• Projects Default views of all projects linked to this team, along with custom views of projects that you can add and edit.
• Views Custom views filtered to this team's issue, visible to members of the team

Team settings⁠

Team settings allow you to configure each team differently to support different workflows.

To access your team's settings:

• From the app sidebar, hover over the team name, click the three dots ··· menu, and select "Team settings."
• From Settings, find the team you want to update from Your teams and select it. It'll take you to the team's unique settings page.

From the team's settings page, you can update the name, icon, and identifier for the team. Changing the issue identifier is a safe action to take -- old URLs containing the original identifier will automatically redirect to the new issue URL.

You can also configure the following settings:

Working with other teams⁠

View other teams⁠

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

You can search for and view issues, projects, and documents from other teams, too, as long as those teams are not 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.

Create teams⁠

To join other teams or create a new one, navigate to settings and select "Join or create a team" from the bottom of the settings sidebar.

• In Settings below the list of your existing Teams, click the + "Add team"
• From command bar Cmd/Ctrl + K, select "Create new team"
• Admins can create teams from their Teams page in settings

Team limits⁠

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

Team creation settings⁠

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

Copy team settings: If you want to copy an existing team's settings when creating a team, use the "Copy team settings..." option when creating a new team.

Restrict team creation: Admins can restrict team creation to only admin users under Settings > Administration > Security.

Tips on structuring teams⁠

Keep these tips 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 up cycles so that all teams follow the same schedule, but you can't view more than one team's cycles at once. Think about how you manage your work, run meetings, measure progress, and whose work you'll want to oversee as a manager.
• Projects can belong to a single team or be shared across many teams (but issues can only be tied to one team)
• 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.

Manage teams⁠

Make a team private⁠

From your team's settings page, you can make a team private. Go to Settings > Your teams > Team and then scroll down to the Danger Zone.

Join / leave / invite teams⁠

Admins can add users to a team in Settings > Administration > 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. Access this by opening the command menu (Cmd/Ctrl K) and searching for "Recently deleted teams".

If you may need the data in the future, consider making the team private, leaving the team, and then exporting the issues or moving the issues to a different team.

⁠