Expedite work using swimlanes
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Your board helps you visualize the flow of work as it moves from defined to completed. When you add swimlanes, you can also visualize the status of work that supports different service-level classes. You can create a swimlane to represent any other dimension that supports your tracking needs.
Prerequisites
Category | Requirements |
---|---|
Access levels | At least Basic access. |
Permissions | To configure team settings: Member of the Project Administrators security group or Team Administrator role. For more information, see Change project-level permissions. |
Types of swimlanes
You can use up to 50 swimlanes to sort work on your board and track items differentiated by the following categories:
- High priority items
- Service-level class
- Date-driven requirements
- Dependencies for or from another team
- Blocked items
- Technical debt or other engineering work that isn't a specific user story
Track work in swimlanes
You can drag items into a swimlane and reorder them within the swimlane.
Tip
- Enter
o
to expand all swimlanes andu
to collapse all swimlanes. To move the focus up or down, enter the↑↓
up/down arrows. For more information, see Keyboard shortcuts. - When you have many swimlanes or cards on your board, you may encounter slow performance when dragging a card. We recommend that you use swimlanes in conjunction with card styles, tags, and board filters to manage your work items. If you have a lot of cards in the default lane, place that lane lower on the board to enhance performance when dragging a card to another swimlane.
Note
The default lane appears unlabeled on the board. You can rename it, but you can't delete it or apply rules to it.
You can also focus on a single swimlane by collapsing all other lanes.
Important
Work items that appear on more than one team's board can yield results that don't meet your expectations because each team can customize its board columns and swimlanes. The values assigned to Board Column, Board Column Done, and Board Lane fields might differ from what you expect when another team updates the work item from a different board. For more information, see Add, review, and update work items in Azure Boards.
Add or remove a swimlane
Identify the swimlanes that support your tracking needs and add them to your board.
Open your board. If you're not a team admin, get added as one. Only team and project administrators can customize the board.
Choose
Configure board settings to configure the board.
Choose Swimlanes, choose Add swimlane, and then enter the name of the swimlane you want to add. For example, here we enter Expedite. You can optionally select the more actions icon
to insert a new swimlane above or below another swimlane.
Note
The following images display the user interface with the New Boards Hub feature enabled by default. For more information, see Manage or enable features.
To set the color of the swimlane, choose a color from the drop-down menu. To reset the swimlane to the default, choose
Reset to default color.
To reorder a swimlane, choose the up or down menu selector
to move it up or down. To remove a swimlane, choose
the trash bin icon, but first move all items out of the lane.
When you're done with your changes, choose Save.
Open your board. If you're not a team admin, get added as one. Only team and project admins can customize the board.
Choose the
gear icon to configure the board and set general team settings.
Choose Swimlanes and then choose the
plus icon and enter the name of the swimlane you want to add.
The default lane appears unlabeled on the board. You can rename it to anything, but you can't delete it. Also, you can rename it directly from the board.
To reorder your swimlanes, grab the lane and move it up or down.
If you need to delete a swimlane, first move all items out of the lane. Then open the Settings dialog, choose the
actions icon and select Remove.
When you're done with your changes, choose Save.
Set up swimlane rules
Swimlane rules are similar to style rules but allow you to set conditions on your board to automatically move work items into specific lanes. For example, you can set up a lane for each person on your team. When you assign a work item, it gets placed into that person's lane.
Swimlane rules are executed in order. Once a rule is met, it executes and moves on to the next work item. For example, if Lane 1 has a rule that says "where priority = 1" and Lane 2 has a rule that says "where priority = 2", a work item with priority = 1 gets moved into Lane 1.
The following limits apply to swimlanes:
- Up to five rules per lane
- A maximum of 25 rules in total
- Only
AND
conditions are supported
Note
Manual movement of items into these lanes is restricted to ensure consistency with the configured rules. To move items into a swimlane with configured rules, ensure that the items meet the criteria defined in the swimlane rules. Adjust the item properties accordingly so that they automatically move into the correct swimlane.
Do the following steps to set up swimlane rules for your board.
From your board, choose the
gear icon to Configure board settings.
Select Swimlanes, select the swimlane or + Add swimlane, and then select + Add criteria.
Choose from the dropdown menus for each of the following entries: Field, Operator, and Value, and then choose Save. For more information, see the examples in the next section.
Tip
You can't assign rules to the Default lane, but you can optionally rename it.
When your board refreshes, your work items are listed within the appropriate swimlane.
Examples of swimlane rules
The following examples show some of the ways you can use and set up swimlane rules.
Track priority. We created rules for the
Work Item Type
andPriority
fields, so work items automatically go into the appropriate swimlane.Settings
Board results
Track the parents of your work items. We created rules for the
Work item type
field, so you can quickly see parents (features) and children (user stories and bugs) in their own swimlanes on the board.Settings
Board results
Track each person's work on your team. We created rules for the
Assigned to
field, so that when you assign a work item, it goes into that user's lane.Settings
Board results
Query for work items based on swimlane
You can track which work items get added to a board swimlane by creating a query and using the Board Lane field.
Next steps
Related articles
REST API resources
To programmatically interact with the board and other team settings, see the REST API, Boards reference.