diff --git a/modules/ROOT/pages/monitoring/logging.adoc b/modules/ROOT/pages/monitoring/logging.adoc
index c95fd4c87..e5417e426 100644
--- a/modules/ROOT/pages/monitoring/logging.adoc
+++ b/modules/ROOT/pages/monitoring/logging.adoc
@@ -6,6 +6,7 @@ Neo4j provides logs for monitoring purposes.
 The logs are stored in the _logs_ directory.
 If you want to use a custom directory, set the path to that directory in the _neo4j.conf_ file by using the parameter xref:configuration/configuration-settings.adoc#config_server.directories.logs[`server.directories.logs`].
 
+
 == Log files
 
 The following table describes the log files that are available in Neo4j and their default configuration.
@@ -338,6 +339,14 @@ The default logging configuration is a good starting point, but you might want t
 The following sections describe some Log4j configuration elements and how to use them to customize the logging configuration.
 For additional information and more advanced customizations, such as filtering and extensions, see the https://logging.apache.org/log4j/2.x/manual/configuration.html[Log4j official documentation on configuration].
 
+[NOTE]
+====
+If Neo4j is embedded in your Java applications, you must provide an implementation of `org.neo4j.logging.LogProvider`.
+Depending on how you set up your log provider, it uses or ignores the _user-logs.xml_ file.
+For details, refer to link:{neo4j-docs-base-uri}/java-reference/{page-version}/java-embedded/logging/[Java Reference -> Using Neo4j embedded in Java applications].
+====
+
+
 [[general-logging-appenders]]
 === Appenders
 All Log4j standard appenders are available in Neo4j.