Overview
A Team represents a cross-functional squad, or any other group of users who work on projects together, or in Shortcut terms, users that collectively own Stories, Epics, and Iterations.
You’ll notice that Teams have specific views below “All Work”, so not only are they important for identifying groups of users, but they’re also incredibly useful for organizing your Workspace.
Think of Teams as the key to unlocking collaboration in Shortcut. Use Teams to organize and measure your work according to the same development teams/squads/pods you already have within your company. This functionality gives your organization the structure to organize with the flexibility to customize to fit how you work.
Teams Structure
Teams empower every Organization to represent people, work, and process more effectively so they can be collaborative and be productive.
- Organize Users into Teams
- Assign Stories to Teams within your workspace development workflow
- Assign Epics to a Team
- Assign Iterations to a Team
- View a Team’s Roadmap
- Quickly find work relevant to your Team
Free plan accounts only have access to one (1) Team for the entire Workspace. For additional access, please consider upgrading to a paid plan.
@ Mentioning a Team
Once a Team is created, you have the ability to @-mention the Team’s handle to notify all team members at once. This is useful for getting input from an entire squad or alerting a team about relevant updates.
Where You Can @-mention a Team
- Within a Story card’s description
- In a Story’s comments
- Within an Epic description
- In an Epic’s comments
- Within an Objective description
- Within an Iteration description
Slack Integration
If you are a Slack user, personal Slack notifications allow you to receive a notification from the “Shortcut” app if a Team in which you are a member is @-mentioned within Shortcut. These personal Slack messages can be responded to in-thread to push a comment to the Story or Epic in Shortcut (and emoji reacts work, too).
Create a connection between your team and slack. In a slack channel, you can have team activity sent to view updates on any Stories, Epics, Roadmap Health, etc. related to that team.
Once you’ve created a Team, assign Stories, Epics, and Iterations to it so the Team owns specific work and you can report on Team progress.
Assigning Stories to Teams
From the Team view: Stories created or moved into this view are automatically assigned to that Team.
From the Stories table or board: Click the Story and set the Team field. Or bulk-assign via Edit # Stories.
Assigning Epics to Teams
Create an Epic from the Team view and it’s auto-assigned. Or set the Team field on an existing Epic.
Assigning Iterations to Teams
Scope an Iteration to a Team from the Team’s Iterations page.
Filtering Work by Team
Filter by Team on Stories, Epics, Iterations, Roadmap, and Reports pages.
Best Practices
- Assign every Story to exactly one Team
- Use Team Iterations for independent cadences
- Review Team capacity via the Status page
- Use Team filters in Reports for velocity and cycle time