Skip to content

🎥 Make videos programmatically with React

Docs: Clarify stacking order in client-side rendering

Jonny Burger4485aa5afd5e
diff --git a/packages/docs/docs/client-side-rendering/limitations.mdx b/packages/docs/docs/client-side-rendering/limitations.mdx
index d46564587d..9f877ee534 100644
--- a/packages/docs/docs/client-side-rendering/limitations.mdx
+++ b/packages/docs/docs/client-side-rendering/limitations.mdx
@@ -169,6 +169,10 @@ See how you can [contribute](/docs/contributing/web-renderer) to add more suppor
## Z-indexing
The CSS property `z-index` is not supported.
+Elements are drawn in DOM order. CSS stacking contexts and the stacking order implied by `position` are not reproduced.
+
+For example, an absolutely positioned text label placed before an [`<Img>`](/docs/img) in JSX is drawn behind the image, even if the browser displays the label on top. Place the label after the image to draw it on top in client-side rendering.
+
To control the order of the elements, [order your elements from back to front](/docs/layers).
```tsx twoslash title="The blue square will be drawn on top of the red square"