diff --git a/assets/images/help/projects-v2/board-column-menu.png b/assets/images/help/projects-v2/board-column-menu.png new file mode 100644 index 0000000000..30c411c339 Binary files /dev/null and b/assets/images/help/projects-v2/board-column-menu.png differ diff --git a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout.md b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout.md index 0624983ebc..b255aa3cc3 100644 --- a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout.md +++ b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout.md @@ -15,6 +15,23 @@ topics: For more information about changing a view to use the board layout, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view#changing-the-project-layout)." +{% ifversion projects-v2-column-limits %} + +## Setting a limit on the number of items in a column + +You can set a limit for the number of cards in a particular column in a board layout. Setting a limit does not restrict anyone from adding cards that would exceed the column's limit, nor does it restrict any automations from adding cards. Column limits are unique to each view in your project. + +The current count of cards and the column's limit is displayed at the top of the column and is highlighted when the current count exceeds the limit. You can use column limits to communicate how you want the column to be used and to make clear at which point action needs to be taken to reduce the number of the cards in the column. + +1. Click {% octicon "kebab-horizontal" aria-label="Column context menu" %} next to the name of the column you want to modify. + ![Screenshot showing a top of a column in the table layout. The column context menu button is highlighted with an orange outline.](/assets/images/help/projects-v2/board-column-menu.png) +1. In the menu, click {% octicon "number" aria-hidden="true" %} **Set column limit**. +1. Under "Column limit", type the card limit for this column. +1. Optionally, to remove the limit, type **0**. +1. Click **Save**. + +{% endif %} + ## Showing and hiding fields {% data reusables.projects.customize.show-hide-field %} diff --git a/data/features/projects-v2-column-limits.yml b/data/features/projects-v2-column-limits.yml new file mode 100644 index 0000000000..e9f4269638 --- /dev/null +++ b/data/features/projects-v2-column-limits.yml @@ -0,0 +1,7 @@ +# Issue 10598 +# Ability to set a limit on the number of items on a column +versions: + fpt: '*' + ghec: '*' + ghes: '>=3.10' + ghae: '>=3.10'