From 3d57a4c9f428138ed25c5aef2879e8b1086484b2 Mon Sep 17 00:00:00 2001
From: Vladimir Levin <vmpstr@chromium.org>
Date: Fri, 17 Oct 2025 12:39:54 -0400
Subject: [PATCH] Specify view-transition-nane: match-element

---
 css-view-transitions-2/Overview.bs | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/css-view-transitions-2/Overview.bs b/css-view-transitions-2/Overview.bs
index 77ac452807a..e23107a56f3 100644
--- a/css-view-transitions-2/Overview.bs
+++ b/css-view-transitions-2/Overview.bs
@@ -537,6 +537,27 @@ spec:css2; type:dfn; text:viewport
 		: <dfn>none</dfn>
 		:: The [=/element=] will not participate independently in a view transition.
 
+		: <dfn>match-element</dfn>
+		:: The [=/element=] will participate in the transition
+			with a user-agent generated name that is unique to the [=/element=].
+
+			<div class="example">
+				```html
+				<style>
+					.card {
+						view-transition-name: match-element;
+					}
+				</style>
+				<div id=e1 class=card>Card 1</div>
+				<div id=e2 class=card>Card 2</div>
+				```
+				In this example, both `#e1` and `#e2` participate in the transition and match against
+				themselves: `#e1` matches with `#e1` and `#e2` matches with `#e2` since they have unique
+				persistent names. In effect, this allows view transition to animate the visual change
+				in several elements with a simple rule.
+			</div>
+
+
 		: <dfn><<custom-ident>></dfn>
 		:: The [=/element=] participates independently in a view transition--
 			as either an old or new [=/element=]--
@@ -544,7 +565,7 @@ spec:css2; type:dfn; text:viewport
 
 			Each [=view transition name=] is a [=tree-scoped name=].
 
-			The values <css>none</css>, <css>auto</css>, and <css>match-element</css> are excluded from <<custom-ident>> here.
+			The values <css>none</css>, and <css>auto</css>, excluded from <<custom-ident>> here.
 
 			Note: If this name is not unique
 			(i.e. if two elements simultaneously specify the same [=view transition name=])