From 20c326b0335cb1e032e564e3a154387d07abe3dd Mon Sep 17 00:00:00 2001
From: Deepanshu Pal <40927968+DeepanshuPal@users.noreply.github.com>
Date: Sun, 27 Sep 2026 17:52:54 +0530
Subject: [PATCH] docs: clarify popper container behavior

---
 docs/api/index.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/api/index.md b/docs/api/index.md
index ee11bddf..63f07dbc 100755
--- a/docs/api/index.md
+++ b/docs/api/index.md
@@ -322,7 +322,11 @@ Padding of the arrow relative to the popper bounds to prevent it from overflowin
 
 ### `container`
 
-Selector: Container where the popper will be appended (e.g. `'body'`).
+Container where the popper will be appended. By default, this is `'body'`.
+Pass a CSS selector such as `'#myButton'` or a DOM element to append it
+there instead. Pass `false` to append it to the reference element's parent.
+The selector must match an element when the popper mounts; otherwise showing
+the popper throws an error.
 
 ### `boundary`