From 2aab9088c0ea9945821fc934998870c8e946dde7 Mon Sep 17 00:00:00 2001
From: "Eric A. Meyer" <eric@meyerweb.com>
Date: Tue, 9 Dec 2025 08:39:09 -0500
Subject: [PATCH] Update wording

---
 files/en-us/web/api/element/attachshadow/index.md         | 3 +++
 files/en-us/web/api/shadowroot/index.md                   | 2 ++
 files/en-us/web/html/reference/elements/template/index.md | 3 +++
 3 files changed, 8 insertions(+)

diff --git a/files/en-us/web/api/element/attachshadow/index.md b/files/en-us/web/api/element/attachshadow/index.md
index 54ec7140d405aac..9584fced6589731 100644
--- a/files/en-us/web/api/element/attachshadow/index.md
+++ b/files/en-us/web/api/element/attachshadow/index.md
@@ -83,6 +83,9 @@ attachShadow(options)
       - : A boolean that, when set to `true`, specifies behavior that mitigates custom element issues around focusability.
         When a non-focusable part of the shadow DOM is clicked, the first focusable part is given focus, and the shadow host is given any available `:focus` styling. Its default value is `false`.
 
+    - `referenceTarget` {{Optional_Inline}} {{Experimental_Inline}}
+      - : A string specifying the _reference target_ of any element references made against the host element of the shadow DOM tree. The reference target must be an element held within the shadow DOM.
+
     - `serializable` {{Optional_Inline}}
       - : A boolean that, when set to `true`, indicates that the shadow root is serializable.
         If set, the shadow root may be serialized by calling the {{DOMxRef('Element.getHTML()')}} or {{DOMxRef('ShadowRoot.getHTML()')}} methods with the `options.serializableShadowRoots` parameter set `true`.
diff --git a/files/en-us/web/api/shadowroot/index.md b/files/en-us/web/api/shadowroot/index.md
index 66c9f029996fd9c..106f23eb8aa7542 100644
--- a/files/en-us/web/api/shadowroot/index.md
+++ b/files/en-us/web/api/shadowroot/index.md
@@ -38,6 +38,8 @@ You can retrieve a reference to an element's shadow root using its {{domxref("El
 - {{DOMxRef("ShadowRoot.pointerLockElement")}} {{ReadOnlyInline}}
   - : Returns the {{DOMxRef('Element')}} set as the target for mouse events while the pointer is locked.
     `null` if lock is pending, pointer is unlocked, or if the target is in another tree.
+- `ShadowRoot.referenceTarget` {{ReadOnlyInline}} {{Experimental_Inline}}
+  - : A string value that indicates the effective target of any element reference made against the shadow host from outside the host element.
 - {{DOMxRef("ShadowRoot.serializable")}} {{ReadOnlyInline}}
   - : A boolean that indicates whether the shadow root is serializable.
     A serializable shadow root inside an element will be serialized by {{DOMxRef('Element.getHTML()')}} or {{DOMxRef('ShadowRoot.getHTML()')}} when its [`options.serializableShadowRoots`](/en-US/docs/Web/API/Element/getHTML#serializableshadowroots) parameter is set `true`.
diff --git a/files/en-us/web/html/reference/elements/template/index.md b/files/en-us/web/html/reference/elements/template/index.md
index 9dafd8ab2166835..ce38e7a8c7d0381 100644
--- a/files/en-us/web/html/reference/elements/template/index.md
+++ b/files/en-us/web/html/reference/elements/template/index.md
@@ -38,6 +38,9 @@ This element includes the [global attributes](/en-US/docs/Web/HTML/Reference/Glo
     If this is set and a non-focusable element in the shadow tree is selected, then focus is delegated to the first focusable element in the tree.
     The value defaults to `false`.
 
+- `shadowrootreferencetarget` {{Experimental_Inline}}
+  - : Sets the value of the `referenceTarget` property of a [`ShadowRoot`](/en-US/docs/Web/API/ShadowRoot) created using this element. The value should be the ID of an element inside the shadow DOM. If set, target references to the host element from outside the shadow DOM will cause the referenced target element to become the effective target of the reference to the host element.
+
 - `shadowrootserializable`
   - : Sets the value of the [`serializable`](/en-US/docs/Web/API/ShadowRoot/serializable) property of a [`ShadowRoot`](/en-US/docs/Web/API/ShadowRoot) created using this element to `true`.
     If set, the shadow root may be serialized by calling the {{DOMxRef('Element.getHTML()')}} or {{DOMxRef('ShadowRoot.getHTML()')}} methods with the `options.serializableShadowRoots` parameter set `true`.