diff --git a/src/asciidoc/index.adoc b/src/asciidoc/index.adoc
index 480170aec55d..8afa1db5ba2b 100644
--- a/src/asciidoc/index.adoc
+++ b/src/asciidoc/index.adoc
@@ -49628,6 +49628,13 @@ options to be specified that influence the way the caching behavior is added to
 application through AOP. The configuration is intentionally similar with that of
 <<tx-annotation-driven-settings, `@Transactional`>>:
 
+[NOTE]
+====
+Advanced customizations using Java config require to implement `CachingConfigurer`, refer
+to {javadoc-baseurl}/org/springframework/cache/annotation/CachingConfigurer.html[the
+javadoc for more details].
+====
+
 [[cache-annotation-driven-settings]]
 .Cache annotation settings
 [cols="1,1,1,3"]