Expedite work using swimlanes

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Your board helps you visualize the flow of work as it moves from defined to completed. Swimlanes let you separate and track different classes of work on your board (for example, high‑priority items, expedited work, or technical debt). You can create swimlanes to represent any dimension that supports your tracking and flow needs.

Tip

You can use AI to help with this task later in this article, or see Enable AI assistance with Azure DevOps MCP Server to get started.

What you'll learn:

• What swimlanes are and when to use them.
• How to add, reorder, color, and remove swimlanes.
• How to configure swimlane rules to automatically route items.
• Limits and availability of swimlane rules.

Quick steps:

1. Open your team board: Overview > Boards.
2. Choose Configure board settings (gear icon) and select Swimlanes.
3. Add or remove swimlanes, set colors, and save.
4. (Optional) Add swimlane rules to automatically place work items.

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 to or from another team
• Blocked items
• Technical debt or other engineering work that isn't a specific user story

Track work in swimlanes

Drag items into a swimlane and reorder them within the swimlane.

Tip

• Press o to expand all swimlanes and u to collapse all swimlanes. Use the arrow keys (↑/↓) to move focus between lanes. For more information, see Keyboard shortcuts.
• If you have many swimlanes or cards, dragging performance might be slower. Use swimlanes in combination with card styles, tags, and board filters to manage large boards. If the default lane contains many cards, place it lower on the board to make dragging to other lanes faster.

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 the 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.

1. Open your board. If you're not a team admin, get added as one. Only team and project administrators can customize the board.

2. Choose Configure board settings.

3. Choose Swimlanes, choose Add swimlane, and enter the swimlane name (for example, Expedite). Use the more actions icon to insert a lane above or below another lane.

   Note

   The following images show the New Boards Hub feature enabled by default. For more information, see Manage or enable features.

   

4. 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.

   

5. To reorder a swimlane, choose the up/down selector . To remove a swimlane, choose the trash icon after you move all items out of the lane.

   

6. When you're done with your changes, choose Save.

Set up swimlane rules

Swimlane rules allow you to automatically route work items into lanes based on field criteria. For example, you can create a lane per person and use a rule that places items into that lane when the item is assigned.

Rules are evaluated in order. When a rule matches, it executes and evaluation continues with the next work item. For example, if Lane 1 has a rule "where Priority = 1" and Lane 2 has "where Priority = 2", an item with Priority = 1 goes to Lane 1.

Limits for swimlane rules:

• Up to five rules per lane
• A maximum of 25 rules in total per board
• Only AND conditions are supported

Note

Manual movement into lanes with configured rules might be restricted to ensure consistency. To move an item into a rule-managed lane, make sure the item meets the lane's rule criteria.

Swimlane rules—availability

• Azure DevOps Services (cloud): swimlane rules are supported and available to cloud organizations.
• Azure DevOps Server (on-premises): availability and feature parity depend on server version. If your on-premises server doesn't show swimlane rules, consider upgrading to a more recent Azure DevOps Server release or consult your server release notes and upgrade guidance to confirm support.

Do the following steps to set up swimlane rules for your board.

1. From your board, choose Configure board settings.

2. Select Swimlanes, select the swimlane or + Add swimlane, and then select + Add criteria.

   

3. Choose the Field, Operator, and Value from the dropdowns, then choose Save. See the following examples of common patterns.

Tip

You can't assign rules to the Default lane, but you can rename it.

When your board refreshes, your work items are listed in the appropriate swimlane.

Examples of swimlane rules

• Track priority
  Create rules for the Work Item Type and Priority fields so items automatically move into the appropriate swimlane.

  Settings

  Board results

• Track parents and children
  Use rules for Work Item Type to highlight features, user stories, and bugs in separate lanes.

  Settings

  Board results

• Track an individual's work
  Create rules for Assigned to so items go to the assigned 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 step

Customize cards

Use AI to manage work across swimlanes

If you have the Azure Boards MCP Server connected to your AI agent in agent mode, you can use natural language prompts to query and manage work items across swimlanes.

Task	Example prompt
Find high-priority items	Show me all work items with Priority 1 on my team's board
View items by board lane	List all work items in the 'Expedite' board lane for the <Contoso> project
Triage items for expediting	Find all active bugs with Severity 1 that might need to be expedited
Check blocked work	Show me all work items tagged 'blocked' that are currently in progress
Identify expedite candidates	List active work items in <Contoso> with priority 1 that are past their target date and not yet in the Expedite lane
Track expedited item age	Show work items in the Expedite board lane for <Contoso> sorted by how many days they've been active
Review lane distribution	Show the count of work items in each board lane for the current sprint in <Contoso>
Find items to demote	List work items in the Expedite lane for <Contoso> where priority was changed from 1 to 2 or lower
Monitor expedite throughput	Show work items that moved out of the Expedite lane in <Contoso> in the last 2 weeks and how long they stayed there
Escalate stalled items	List work items tagged 'blocked' in <Contoso> that haven't been updated in more than 3 days

Note

Agent mode and the MCP Server use natural language, so you can adjust these prompts or ask follow-up questions to refine the results.

Related content

• About teams and Agile tools
• Query by assignment or workflow changes
• Add columns
• Split columns

REST API resources

To programmatically interact with the board and other team settings, see the REST API, Boards reference.