diff --git a/language/oop5/traits.xml b/language/oop5/traits.xml
index 30b020289482..848240a1cdd6 100644
--- a/language/oop5/traits.xml
+++ b/language/oop5/traits.xml
@@ -423,6 +423,13 @@ Example::doSomething();
    </example>
    <example xml:id="language.oop5.traits.static.ex3">
     <title>Static Properties</title>
+    <caution>
+     <simpara>
+      Prior to PHP 8.3.0, static properties were shared across all classes
+      using the trait. As of PHP 8.3.0, each class using the trait has its
+      own copy of the static property.
+     </simpara>
+    </caution>
     <programlisting role="php">
      <![CDATA[
 <?php