diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/developing-web-applications.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/developing-web-applications.adoc
index 60c87a03a062..79f77ddf3583 100644
--- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/developing-web-applications.adoc
+++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/developing-web-applications.adoc
@@ -457,6 +457,9 @@ The `ObjectMapper` is customized by setting the various `spring.jackson.*` prope
 You can take control of Spring HATEOAS's configuration by using `@EnableHypermediaSupport`.
 Note that doing so disables the `ObjectMapper` customization described earlier.
 
+NOTE: Spring Boot only supports Spring HATEOAS with Spring MVC.
+Adding Spring HATEOAS to a Spring Boot application with Spring WebFlux can cause the application to fail.
+
 
 
 [[features.developing-web-applications.spring-mvc.cors]]