@@ -226,6 +226,19 @@ CREATE SUBSCRIPTION <replaceable class="PARAMETER">subscription_name</replaceabl
226226 how to configure access control between the subscription and the
227227 publication instance.
228228 </para>
229+
230+ <para>
231+ Creating a subscription that connects to the same database cluster (for
232+ example, to replicate between databases in the same cluster or to replicate
233+ within the same database) will only succeed if the replication slot is not
234+ created as part of the same command. Otherwise, the <command>CREATE
235+ SUBSCRIPTION</command> call will hang. To make this work, create the
236+ replication slot separately (using the
237+ function <function>pg_create_logical_replication_slot</function> with the
238+ plugin name <literal>pgoutput</literal>) and create the subscription using
239+ the parameter <literal>create_slot = false</literal>. This is an
240+ implementation restriction that might be lifted in a future release.
241+ </para>
229242 </refsect1>
230243
231244 <refsect1>