diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index a49a14cac1d..764d24a2d71 100644
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -3386,6 +3386,15 @@ ALTER INDEX measurement_city_id_logdate_key
       </para>
      </listitem>
 
+     <listitem>
+      <para>
+       Unique constraints on partitioned tables must include all the
+       partition key columns.  This limitation exists because
+       <productname>PostgreSQL</productname> can only enforce
+       uniqueness in each partition individually.
+      </para>
+     </listitem>
+
      <listitem>
       <para>
        While primary keys are supported on partitioned tables, foreign