diff --git a/doc/source/ray-core/scheduling/placement-group.rst b/doc/source/ray-core/scheduling/placement-group.rst
index d78fbdcb88e4..339c23bb4875 100644
--- a/doc/source/ray-core/scheduling/placement-group.rst
+++ b/doc/source/ray-core/scheduling/placement-group.rst
@@ -577,6 +577,11 @@ child tasks and actors to the same placement group, specify ``PlacementGroupSche
   :start-after: __child_capture_disable_pg_start__
   :end-before: __child_capture_disable_pg_end__
 
+.. warning::
+  The value of ``placement_group_capture_child_tasks`` for a given actor isn't inherited from its parent. If you're creating nested actors of depth greater than 1 
+  and should all use the same placement group, you should explicitly set ``placement_group_capture_child_tasks`` explicitly set for each actor.
+  
+
 [Advanced] Named Placement Group
 --------------------------------