diff --git a/api/src/main/java/jakarta/faces/component/UIForm.java b/api/src/main/java/jakarta/faces/component/UIForm.java
index a153a417d3..a47a372981 100644
--- a/api/src/main/java/jakarta/faces/component/UIForm.java
+++ b/api/src/main/java/jakarta/faces/component/UIForm.java
@@ -70,7 +70,9 @@ enum PropertyKeys {
          * <p>
          * The prependId flag.
          * </p>
+         * @deprecated This attribute breaks the {@link UIComponent#findComponent(String)}.
          */
+        @Deprecated(since = "5.0", forRemoval = true)
         prependId,
 
         /**
@@ -146,7 +148,9 @@ public void setSubmitted(boolean submitted) {
      * Is the id prepended.
      *
      * @return <code>true</code> if it is, <code>false</code> otherwise.
+     * @deprecated This attribute breaks the {@link UIComponent#findComponent(String)}.
      */
+    @Deprecated(since = "5.0", forRemoval = true)
     public boolean isPrependId() {
         return (Boolean) getStateHelper().eval(PropertyKeys.prependId, true);
     }
@@ -155,7 +159,9 @@ public boolean isPrependId() {
      * Set whether the id should be prepended.
      * 
      * @param prependId <code>true</code> if it is, <code>false</code> otherwise.
+     * @deprecated This attribute breaks the {@link UIComponent#findComponent(String)}.
      */
+    @Deprecated(since = "5.0", forRemoval = true)
     public void setPrependId(boolean prependId) {
         getStateHelper().put(PropertyKeys.prependId, prependId);
     }
diff --git a/api/src/main/vdldoc/faces.html.taglib.xml b/api/src/main/vdldoc/faces.html.taglib.xml
index e3c2ec8a67..95a37fbec8 100644
--- a/api/src/main/vdldoc/faces.html.taglib.xml
+++ b/api/src/main/vdldoc/faces.html.taglib.xml
@@ -3356,9 +3356,15 @@
         </attribute>
         <attribute>
             <description>
+                <![CDATA[
+                <strong>
+                    The use of this attribute has been <a href="https://github.com/jakartaee/faces/issues/1972">deprecated</a> in Faces 5.0, without replacement.
+                </strong>
+                <br/><br/>
                 Flag indicating whether or not this form should prepend its id
                 to its descendent's id during the clientId generation process.
                 If this flag is not set, the default value is true.
+                ]]>
             </description>
             <name>prependId</name>
             <required>false</required>