From a256a334b9d3459bfe7ab9886dee582f732a2fae Mon Sep 17 00:00:00 2001 From: Tim Nguyen Date: Thu, 8 Jan 2026 11:51:51 +0900 Subject: [PATCH 1/3] [css-grid-3] Rename 'item-tolerance' to 'flow-tolerance' Fixes https://github.com/w3c/csswg-drafts/issues/10884 --- css-grid-3/Overview.bs | 53 +++++++++++++++++++++--------------------- 1 file changed, 26 insertions(+), 27 deletions(-) diff --git a/css-grid-3/Overview.bs b/css-grid-3/Overview.bs index 5d07aa383a54..a51845df9cde 100644 --- a/css-grid-3/Overview.bs +++ b/css-grid-3/Overview.bs @@ -261,7 +261,7 @@ Reordering and Accessibility (placing the next item endward of the current item in at least one axis, matching the natural “reading order”), it can switch between endward in the inline or block axis in a seemingly arbitrary manner. - In simple cases, the 'item-tolerance' property can help reduce + In simple cases, the 'flow-tolerance' property can help reduce the feeling of backtracking due to small sizing differences in the [=stacking axis=] when laying out auto-placed items. But when [[#grid-lanes-layout-algorithm|auto-placement]] is mixed with [=definite position|explicit placement=] or spanning items, @@ -321,7 +321,7 @@ Reordering and Accessibility
Techniques for reducing backtracking include: - * Using appropriate values for 'item-tolerance', + * Using appropriate values for 'flow-tolerance', i.e. values large enough to avoid gratuitous differentiation among similarly-sized tracks, but not so large that meaningful differences get ignored. * Using explicit placement in ways that help group related items together, @@ -761,10 +761,10 @@ Specifying Grid Axis Item Placement: the 'grid-column-*' and 'grid-row-*' proper and establish placement just as in regular [=grid layout=].

-Placement Precision: the 'item-tolerance' property

+Placement Precision: the 'flow-tolerance' property 
-	Name: item-tolerance
+	Name: flow-tolerance
 	Value: normal | <> | infinite
 	Initial: normal
 	Percentages: relative to the [=grid-axis=] [=content box=] size of the [=grid lanes container=]
@@ -783,11 +783,11 @@ Placement Precision: the 'item-tolerance' property
 	it can look strange to have them not fill in order,
 	as the height differences aren't perceived as meaningfully different.
 
-	The 'item-tolerance' property specifies what the threshold is
+	The 'flow-tolerance' property specifies what the threshold is
 	for considering tracks to be “the same height”,
 	causing them to fill in order.
 
-	

+	

 		: <>
 		:: Specifies the tie threshold
 			for the [=grid lanes container=].
@@ -836,8 +836,6 @@ Placement Precision: the 'item-tolerance' property
 		only the fourth column is a possible placement.
- ISSUE(10884): The CSSWG is open to better names for this property. - Note: We expect to apply this property to [=flex layout=] in the future also, see discussions on how that might work. @@ -1332,8 +1330,8 @@ Appendix A: Generic Layout Item Flow Controls: the 'item-*' properties 'grid-auto-flow' - 'item-tolerance' - 'item-tolerance' + 'flow-tolerance' + 'flow-tolerance' normal | <> | infinite Defines a layout-specific amount of “slack” in placement decisions. @@ -1534,7 +1532,7 @@ Item Placement Shorthand: the 'item-flow' shorthand 
 	Name: item-flow
-	Value: <<'item-direction'>> || <<'item-wrap'>> || <<'item-pack'>> || <<'item-tolerance'>>
+	Value: <<'item-direction'>> || <<'item-wrap'>> || <<'item-pack'>> || <<'flow-tolerance'>>
This [=shorthand property=] sets all its 'item-*' [=longhand properties=] @@ -1598,7 +1596,6 @@ Recent Changes The following changes have been made since the 17 September 2025 Working Draft: - * Defined a new inner display type, ''display/grid-lanes'', to establish [=grid lanes layout=], and updated spec vocabulary to match. (Issue 12022) @@ -1608,6 +1605,8 @@ Recent Changes (Issue 12899) * Floored the contribution of items to a track's [=running position=] at zero. (Issue 12918) + * Renamed ''item-tolerance'' to ''flow-tolerance''. + (Issue 10884) See also earlier changes. @@ -1782,18 +1781,18 @@ item-placement/grid-lanes-item-placement-006.html item-placement/grid-lanes-item-placement-007.html item-placement/grid-lanes-item-placement-008.html item-placement/grid-lanes-rows-with-grid-width-changed.html -item-placement/item-tolerance/column-initial-item-tolerance.html -item-placement/item-tolerance/column-item-tolerance-infinite.html -item-placement/item-tolerance/item-tolerance-column-001.html -item-placement/item-tolerance/item-tolerance-column-002.html -item-placement/item-tolerance/item-tolerance-column-003.html -item-placement/item-tolerance/item-tolerance-column-004.html -item-placement/item-tolerance/item-tolerance-row-001.html -item-placement/item-tolerance/item-tolerance-row-002.html -item-placement/item-tolerance/item-tolerance-row-003.html -item-placement/item-tolerance/item-tolerance-row-004.html -item-placement/item-tolerance/row-initial-item-tolerance.html -item-placement/item-tolerance/row-item-tolerance-infinite.html +item-placement/flow-tolerance/column-initial-flow-tolerance.html +item-placement/flow-tolerance/column-flow-tolerance-infinite.html +item-placement/flow-tolerance/flow-tolerance-column-001.html +item-placement/flow-tolerance/flow-tolerance-column-002.html +item-placement/flow-tolerance/flow-tolerance-column-003.html +item-placement/flow-tolerance/flow-tolerance-column-004.html +item-placement/flow-tolerance/flow-tolerance-row-001.html +item-placement/flow-tolerance/flow-tolerance-row-002.html +item-placement/flow-tolerance/flow-tolerance-row-003.html +item-placement/flow-tolerance/flow-tolerance-row-004.html +item-placement/flow-tolerance/row-initial-flow-tolerance.html +item-placement/flow-tolerance/row-flow-tolerance-infinite.html item-placement/row-auto-placement-001.html item-placement/row-auto-placement-002.html item-placement/row-auto-placement-max-content.html @@ -1866,9 +1865,9 @@ parsing/grid-lanes-shorthand-computed.html parsing/grid-lanes-shorthand-invalid.html parsing/grid-lanes-shorthand-serialization.html parsing/grid-lanes-shorthand-valid.html -parsing/item-tolerance-computed.html -parsing/item-tolerance-invalid.html -parsing/item-tolerance-valid.html +parsing/flow-tolerance-computed.html +parsing/flow-tolerance-invalid.html +parsing/flow-tolerance-valid.html row-empty-grid-lanes-container-001.html row-empty-grid-lanes-container-002.html row-min-max-content-container.html From b35a76241a97b4a163bb4f99bcfceec2f6d5ac7e Mon Sep 17 00:00:00 2001 From: Tim Nguyen Date: Thu, 8 Jan 2026 11:55:49 +0900 Subject: [PATCH 2/3] Update old IDs for placement tolerance header --- css-grid-3/Overview.bs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/css-grid-3/Overview.bs b/css-grid-3/Overview.bs index a51845df9cde..81d26279b70b 100644 --- a/css-grid-3/Overview.bs +++ b/css-grid-3/Overview.bs @@ -760,7 +760,7 @@ Specifying Grid Axis Item Placement: the 'grid-column-*' and 'grid-row-*' proper apply in the [=grid axis=] of the items and establish placement just as in regular [=grid layout=]. -

+

Placement Precision: the 'flow-tolerance' property


From 9f96ce0285ba32b669854311e51356a72774d9c6 Mon Sep 17 00:00:00 2001
From: Tim Nguyen 
Date: Thu, 8 Jan 2026 12:08:05 +0900
Subject: [PATCH 3/3] drop fixup

---
 css-grid-3/Overview.bs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/css-grid-3/Overview.bs b/css-grid-3/Overview.bs
index 81d26279b70b..a51845df9cde 100644
--- a/css-grid-3/Overview.bs
+++ b/css-grid-3/Overview.bs
@@ -760,7 +760,7 @@ Specifying Grid Axis Item Placement: the 'grid-column-*' and 'grid-row-*' proper
 	apply in the [=grid axis=] of the items
 	and establish placement just as in regular [=grid layout=].
 
-

+

 Placement Precision: the 'flow-tolerance' property