diff --git a/spring-batch-docs/asciidoc/step.adoc b/spring-batch-docs/asciidoc/step.adoc
index 95ebd233d..ff02d3941 100644
--- a/spring-batch-docs/asciidoc/step.adoc
+++ b/spring-batch-docs/asciidoc/step.adoc
@@ -2468,3 +2468,11 @@ The following example includes a bean that explicitly defines the `JobScope`:
 ----
 <bean class="org.springframework.batch.core.scope.JobScope" />
 ----
+
+[NOTE]
+====
+There are some practical limitations of using job-scoped beans in multi-threaded
+or partitioned steps. Spring Batch does not control the threads spawned in these
+use cases, so it is not possible to set them up correctly to use such beans. Hence,
+it is not recommended to use job-scoped beans in multi-threaded or partitioned steps.
+====