You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
21
+
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.
22
+
23
+
What you'll learn:
24
+
- What swimlanes are and when to use them.
25
+
- How to add, reorder, color, and remove swimlanes.
26
+
- How to configure swimlane rules to automatically route items.
27
+
- Limits and availability of swimlane rules.
28
+
29
+
Quick steps:
30
+
1. Open your team board: **Overview** > **Boards**.
31
+
2. Choose **Configure board settings** (gear icon) and select **Swimlanes**.
32
+
3. Add or remove swimlanes, set colors, and save.
33
+
4. (Optional) Add swimlane rules to automatically place work items.
22
34
23
35
## Prerequisites
24
36
@@ -30,165 +42,139 @@ You can use up to 50 swimlanes to sort work on your board and track items differ
30
42
- High priority items
31
43
- Service-level class
32
44
- Date-driven requirements
33
-
- Dependencies for or from another team
45
+
- Dependencies to or from another team
34
46
- Blocked items
35
47
- Technical debt or other engineering work that isn't a specific user story
36
48
37
49
## Track work in swimlanes
38
50
39
-
You can drag items into a swimlane and reorder them within the swimlane.
51
+
Drag items into a swimlane and reorder them within the swimlane.
40
52
41
53
> [!TIP]
42
-
> -Enter`o` to expand all swimlanes and `u` to collapse all swimlanes. To move the focus up or down, enter the `↑↓` up/down arrows. For more information, see [Keyboard shortcuts](../../project/navigation/keyboard-shortcuts.md).
43
-
> -When you have many swimlanes or cards on your board, you might encounter slow performance when dragging a card. We recommend that you use swimlanes with card styles, tags, and board filters to manage your work items. If you have numerous cards in the default lane, place that lane lower on the board to enhance performance when dragging a card to another swimlane.
54
+
> -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](../../project/navigation/keyboard-shortcuts.md).
55
+
> -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.
44
56
45
57
> [!div class="mx-imgBorder"]
46
-
> 
58
+
> 
47
59
48
60
> [!NOTE]
49
61
> The default lane appears unlabeled on the board. You can rename it, but you can't delete it or apply rules to it.
50
62
51
-
You can also focus on a single swimlane by collapsing all other lanes.
63
+
You can also focus on a single swimlane by collapsing the other lanes.
52
64
53
65
> [!div class="mx-imgBorder"]
54
-
> 
66
+
> 
Identify the swimlanes that support your tracking needs and add them to your board.
61
73
62
74
::: moniker range="azure-devops"
63
75
64
76
1.[Open your board](kanban-quickstart.md). If you're not a team admin, [get added as one](../../organizations/settings/add-team-administrator.md). Only team and project administrators can customize the board.
65
-
66
-
2. Choose :::image type="icon" source="../../media/icons/blue-gear.png" border="false"::: **Configure board settings** to configure the board.
67
-
68
-
:::image type="content" source="media/expedite/choose-configure-board-settings.png" alt-text="Screenshot of board, Choose Configure board settings.":::
69
-
70
-
3. 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 :::image type="icon" source="../../media/icons/more-actions.png" border="false"::: to insert a new swimlane above or below another swimlane.
3. Choose **Swimlanes**, choose **Add swimlane**, and enter the swimlane name (for example, *Expedite*). Use the more actions icon :::image type="icon" source="../../media/icons/more-actions.png" border="false"::: to insert a lane above or below another lane.
:::image type="content" source="media/expedite/add-swimlane-new-board-hubs-enabled.png" alt-text="Screenshot showing the Add swimlane dialog in board settings.":::
75
83
76
-
4. To set the color of the swimlane, choose a color from the drop-down menu. To reset the swimlane to the default, choose :::image type="icon" source="../media/icons/refresh.png" border="false"::: **Reset to default color**.
84
+
4. To set the color of the swimlane, choose a color from the drop-down menu. To reset the swimlane to the default, choose :::image type="icon" source="../media/icons/refresh.png" border="false"::: **Reset to default color**.
:::image type="content" source="media/expedite/pick-swimlane-color.png" alt-text="Screenshot showing the swimlane color picker.":::
79
87
80
-
5. To reorder a swimlane, choose the up or down menu selector :::image type="icon" source="../../media/icons/context-menu-selector.png" border="false"::: to move it up or down. To remove a swimlane, choose :::image type="icon" source="../media/icons/trash-can.png" border="false"::: the trash bin icon, but first move all items out of the lane.
88
+
5. To reorder a swimlane, choose the up/down selector :::image type="icon" source="../../media/icons/context-menu-selector.png" border="false":::. To remove a swimlane, choose the trash icon :::image type="icon" source="../media/icons/trash-can.png" border="false"::: after you move all items out of the lane.
81
89
82
-
:::image type="content" source="media/expedite/move-remove-swimlane-options.png" alt-text="Screenshot of board Settings, Swimlane tab, swimlane menu options.":::
90
+
:::image type="content" source="media/expedite/move-remove-swimlane-options.png" alt-text="Screenshot showing reorder and remove swimlane options.":::
83
91
84
92
6. When you're done with your changes, choose **Save**.
85
93
86
94
::: moniker-end
87
95
88
-
::: moniker range=" < azure-devops"
89
-
90
-
1.[Open your board](kanban-quickstart.md). If you're not a team admin, [get added as one](../../organizations/settings/add-team-administrator.md). Only team and project admins can customize the board.
96
+
::: moniker range="<azure-devops"
91
97
92
-
2. Choose the :::image type="icon" source="../../media/icons/blue-gear.png" border="false"::: gear icon to configure the board and set general team settings.
93
-
94
-
> [!div class="mx-imgBorder"]
95
-
> 
96
-
97
-
3. Choose **Swimlanes** and then choose the :::image type="icon" source="../media/icons/green_plus_icon.png" border="false"::: plus icon and enter the name of the swimlane you want to add.
98
-
99
-
> [!div class="mx-imgBorder"]
100
-
> 
101
-
102
-
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.
103
-
104
-
4. To reorder your swimlanes, grab the lane and move it up or down.
98
+
1.[Open your board](kanban-quickstart.md). If you're not a team admin, [get added as one](../../organizations/settings/add-team-administrator.md). Only team and project admins can customize the board.
99
+
2. Choose the :::image type="icon" source="../../media/icons/blue-gear.png" border="false"::: gear icon to configure the board and set team settings.
100
+
3. Choose **Swimlanes** and then choose the :::image type="icon" source="../media/icons/green_plus_icon.png" border="false"::: plus icon and enter the swimlane name.
105
101
106
102
> [!div class="mx-imgBorder"]
107
-
> 
103
+
> 
108
104
109
-
5. If you need to delete a swimlane, first move all items out of the lane. Then open the Settings dialog, choose the :::image type="icon" source="../../media/icons/actions-icon.png" border="false"::: actions icon, and select **Remove**.
110
-
111
-
> [!div class="mx-imgBorder"]
112
-
> 
113
-
114
-
6. When you're done with your changes, choose **Save**.
105
+
4. To reorder swimlanes, grab a lane and move it up or down.
106
+
5. To delete a swimlane, first move all items out of it. Then open Settings, choose the :::image type="icon" source="../../media/icons/actions-icon.png" border="false"::: actions icon, and select **Remove**.
107
+
6. When you're done with changes, choose **Save**.
115
108
116
109
::: moniker-end
117
110
118
-
::: moniker range="azure-devops"
119
-
120
111
## Set up swimlane rules
121
112
122
-
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.
113
+
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.
123
114
124
-
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.
115
+
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.
125
116
126
-
The following limits apply to swimlanes:
117
+
Limits for swimlane rules:
127
118
- Up to five rules per lane
128
-
- A maximum of 25 rules in total
129
-
- Only `AND` conditions are supported
119
+
- A maximum of 25 rules in total per board
120
+
- Only AND conditions are supported
130
121
131
122
> [!NOTE]
132
-
> 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.
123
+
> 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.
124
+
125
+
### Swimlane rules—availability
126
+
127
+
- Azure DevOps Services (cloud): swimlane rules are supported and available to cloud organizations.
128
+
- 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.
133
129
134
130
Do the following steps to set up swimlane rules for your board.
135
131
136
132
1. From your board, choose the :::image type="icon" source="../../media/icons/team-settings-gear-icon.png" border="false"::: gear icon to **Configure board settings**.
137
-
138
133
2. Select **Swimlanes**, select the **swimlane** or **[+ Add swimlane](#add-or-remove-a-swimlane)**, and then select **+ Add criteria**.
139
134
140
-
:::image type="content" source="media/expedite/add-swimlane-criteria.png" alt-text="Screenshot showing sequence of buttons to select to add a swimlane rule.":::
3. 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](#examples-of-swimlane-rules).
143
-
144
-
:::image type="content" source="media/expedite/swimlane-rule-criteria.png" alt-text="Screenshot showing field, operator, and value selections for swimlane rule.":::
137
+
3. Choose the **Field**, **Operator**, and **Value** from the dropdowns, then choose **Save**. See the following examples of common patterns.
145
138
146
139
> [!TIP]
147
-
> You can't assign rules to the Default lane, but you can optionally rename it.
140
+
> You can't assign rules to the Default lane, but you can rename it.
148
141
149
-
When your board refreshes, your work items are listed within the appropriate swimlane.
142
+
When your board refreshes, your work items are listed in the appropriate swimlane.
150
143
151
144
### Examples of swimlane rules
152
145
153
-
The following examples show some of the ways you can use and set up swimlane rules.
146
+
-**Track priority**
147
+
Create rules for the `Work Item Type` and `Priority` fields so items automatically move into the appropriate swimlane.
154
148
155
-
-**Track priority**. We created rules for the `Work Item Type` and `Priority` fields, so work items automatically go into the appropriate swimlane.
156
-
157
149
**Settings**
158
-
159
150
:::image type="content" source="media/expedite/priority-swimlane-rule-setup.png" alt-text="Screenshot showing swimlane rules set up by priority.":::
160
-
151
+
161
152
**Board results**
153
+
:::image type="content" source="media/expedite/board-priority-swimlanes.png" alt-text="Screenshot showing board with priority swimlanes.":::
162
154
163
-
:::image type="content" source="media/expedite/board-priority-swimlanes.png" alt-text="Screenshot showing priority swimlanes on board.":::
155
+
-**Track parents and children**
156
+
Use rules for `Work Item Type` to highlight features, user stories, and bugs in separate lanes.
164
157
165
-
-**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.
166
-
167
158
**Settings**
159
+
:::image type="content" source="media/expedite/work-item-type-swimlane-rule-setup.png" alt-text="Screenshot showing rules for work item types.":::
168
160
169
-
:::image type="content" source="media/expedite/work-item-type-swimlane-rule-setup.png" alt-text="Screenshot showing rules set up for work item types.":::
170
-
171
161
**Board results**
172
-
173
-
:::image type="content" source="media/expedite/board-track-parent-work-items-swimlanes.png" alt-text="Screenshot showing parent work item swimlanes on board.":::
162
+
:::image type="content" source="media/expedite/board-track-parent-work-items-swimlanes.png" alt-text="Screenshot showing board with parent/child swimlanes.":::
163
+
164
+
-**Track an individual's work**
165
+
Create rules for `Assigned to` so items go to the assigned user's lane.
174
166
175
-
-**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.
176
-
177
167
**Settings**
178
-
179
-
:::image type="content" source="media/expedite/assigned-to-swimlane-rule-setup.png" alt-text="Screenshot showing rule criteria for swimlane, by Assigned To field.":::
180
-
181
-
**Board results**
182
-
183
-
:::image type="content" source="media/expedite/board-assigned-to-swimlanes.png" alt-text="Screenshot showing swimlanes grouped by priority.":::
168
+
:::image type="content" source="media/expedite/assigned-to-swimlane-rule-setup.png" alt-text="Screenshot showing rule criteria for swimlane by Assigned To.":::
184
169
185
-
::: moniker-end
170
+
**Board results**
171
+
:::image type="content" source="media/expedite/board-assigned-to-swimlanes.png" alt-text="Screenshot showing board with swimlanes grouped by assigned person.":::
186
172
187
173
## Query for work items based on swimlane
188
174
189
175
You can track which work items get added to a board swimlane by creating a query and using the [Board Lane field](../queries/query-by-workflow-changes.md#kanban_query_fields).
0 commit comments