Teams

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

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:

• Group teammates who work together frequently.
• Group areas of work such as marketing, mobile app, etc.
• In small organizations, keeping everyone on one team is the simplest approach.

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 and move issues from one team to another.

View your teams⁠

Teams you have joined appear in your sidebar. To join other teams, navigate to the Teams view on your sidebar.

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

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

Within a team, you'll find 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

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:

Team settings⁠

Team settings allow you to configure each team differently to support different ways your teams work. If you want all team settings to match across the workspace, use the copy team settings option during team creation to match your new team's settings to an existing team.

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. Access this from the Teams page in your sidebar as pictured.

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.

⁠