From 63a940533a6459d11b483b9e0f79cc408c0c8a99 Mon Sep 17 00:00:00 2001
From: DevGeniusCode <136935333+DevGeniusCode@users.noreply.github.com>
Date: Fri, 10 Apr 2026 01:13:09 +0300
Subject: [PATCH] Update wnd_controls_combobox.md with Z-order details

Added note about dropdown menu Z-order and overlap issues.
---
 Asset/GUI/WND_Controls/wnd_controls_combobox.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Asset/GUI/WND_Controls/wnd_controls_combobox.md b/Asset/GUI/WND_Controls/wnd_controls_combobox.md
index 0f7400f0..21f7f8a6 100644
--- a/Asset/GUI/WND_Controls/wnd_controls_combobox.md
+++ b/Asset/GUI/WND_Controls/wnd_controls_combobox.md
@@ -105,6 +105,10 @@ The following section list the default values and available textures for each ta
    If the ComboBox is inside a window container and the list extends beyond the window's boundaries,
    it is not possible to click on items that are outside of the visible area of the container.
    This may cause issues when interacting with the ComboBox.
+3. **Dropdown Menu Z-Order (Overlap issues):**
+   The SAGE engine renders UI elements based on their order in the `.wnd` file hierarchy. Elements defined lower down in the file are drawn on top of elements defined earlier. 
+   Because the ComboBox features a dropdown list that extends downwards, it must be rendered *over* any other UI elements that are physically located below it on the screen.
+   To ensure the dropdown menu is not hidden     behind other elements, the `COMBOBOX` must be placed **below** those underlying elements in the `.wnd` file's code hierarchy.
 
 ## Example