From c7d45fe51a67af7a8bd61e47f2627584026f9b21 Mon Sep 17 00:00:00 2001
From: cx384 <cx384@proton.me>
Date: Sat, 6 Sep 2025 11:44:46 +0200
Subject: [PATCH] Add formspec box color documentation to style section

---
 doc/lua_api.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/lua_api.md b/doc/lua_api.md
index 9a9821abc4..7182bedc48 100644
--- a/doc/lua_api.md
+++ b/doc/lua_api.md
@@ -3612,6 +3612,8 @@ Some types may inherit styles from parent types.
 * animated_image
     * noclip - boolean, set to true to allow the element to exceed formspec bounds.
 * box
+    * **Note**: In order for any of the styling options to take effect,
+                the `color` field in the box element must be left unspecified.
     * noclip - boolean, set to true to allow the element to exceed formspec bounds.
         * Defaults to false in formspec_version version 3 or higher
     * **Note**: `colors`, `bordercolors`, and `borderwidths` accept multiple input types: