diff --git a/docs/src/main/asciidoc/intro.adoc b/docs/src/main/asciidoc/intro.adoc
index c4d7f6217..2123efc36 100644
--- a/docs/src/main/asciidoc/intro.adoc
+++ b/docs/src/main/asciidoc/intro.adoc
@@ -158,6 +158,9 @@ Below you can find an example of a Logback configuration (file named `https://gi
 include::https://raw.githubusercontent.com/spring-cloud-samples/sleuth-documentation-apps/master/service1/src/main/resources/logback-spring.xml[]
 -----
 
+NOTE: If you're using a custom `logback-spring.xml` then you have to pass the `spring.application.name` in
+`bootstrap` instead of `application` property file. Otherwise your custom logback file won't read the property properly.
+
 === Adding to the project
 
 ==== Only Sleuth (log correlation)