From f1228e86fbe0eacb7bfbd4472beb02b9e404b1a7 Mon Sep 17 00:00:00 2001
From: Xon <635541+Xon@users.noreply.github.com>
Date: Sat, 7 Feb 2026 13:50:15 +0800
Subject: [PATCH] Document dropdownParent config option

---
 README.md                         | 8 ++++++++
 src/scripts/interfaces/options.ts | 7 +++++++
 2 files changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 7b736a29..aa7e5042 100644
--- a/README.md
+++ b/README.md
@@ -536,6 +536,14 @@ var choices = new Choices(el, {
 });
 ```
 
+### dropdownParent
+
+**Type:** `string | null` **Default:** null
+
+**Input types affected:** `select-one`, `select-multiple`
+
+**Usage:**  CSS selector for the element to append the dropdown to. Similar to select2's appendTo option
+
 ### position
 
 **Type:** `String` **Default:** `auto`
diff --git a/src/scripts/interfaces/options.ts b/src/scripts/interfaces/options.ts
index 53a58c94..249de18b 100644
--- a/src/scripts/interfaces/options.ts
+++ b/src/scripts/interfaces/options.ts
@@ -635,5 +635,12 @@ export interface Options {
 
   appendGroupInSearch: boolean;
 
+  /**
+   * CSS selector for the element to append the dropdown to. Similar to select2's appendTo option
+   *
+   * **Input types affected:** `select-one`, `select-multiple`
+   *
+   * @default null
+   */
   dropdownParent: string | null;
 }