diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index a889ffc54722388543349edfc926b2cbd65d5e6a..449b54fa67c5b16635021b921beb596b5d584d6d 100644
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -3246,6 +3246,15 @@ ANALYZE measurement;
      </para>
     </listitem>
 
+    <listitem>
+     <para>
+      <command>INSERT</command> statements with <literal>ON CONFLICT</>
+      clauses are unlikely to work as expected, as the <literal>ON CONFLICT</>
+      action is only taken in case of unique violations on the specified
+      target relation, not its child relations.
+     </para>
+    </listitem>
+
    </itemizedlist>
    </para>