diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 5560b95ee60..acf63924a9c 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -3064,6 +3064,13 @@ include_dir 'conf.d'
         values <literal>archive</literal> and <literal>hot_standby</literal>.
         These are still accepted but mapped to <literal>replica</literal>.
        </para>
+       <note>
+        <para>
+         Setting <literal>wal_level=logical</literal> enables logical decoding.
+         It is a prerequisite for logical replication, but by itself
+         does not configure logical replication; see <xref linkend="logical-replication"/>.
+        </para>
+       </note>
       </listitem>
      </varlistentry>