From 1645c1b8a15e114621d58abfeea5b46222e770e0 Mon Sep 17 00:00:00 2001
From: Erkan <33022765+erkcet@users.noreply.github.com>
Date: Tue, 24 Feb 2026 01:16:22 +0300
Subject: [PATCH] Documentation: clarify array value quoting in Docker label
 mapping syntax (#6356)

Co-authored-by: shamoon <shamoon@users.noreply.github.com>
---
 docs/configs/docker.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/configs/docker.md b/docs/configs/docker.md
index 0fffc9626..32d01c0f6 100644
--- a/docs/configs/docker.md
+++ b/docs/configs/docker.md
@@ -177,6 +177,16 @@ labels:
   - homepage.widget.fields=["field1","field2"] # optional
 ```
 
+!!! note
+
+    If you use mapping syntax (`:`) for labels instead of list syntax (`-`), array values like `fields` must be wrapped in single quotes so they are passed as a string:
+
+    ```yaml
+    labels:
+      ...
+      homepage.widget.fields: '["field1","field2"]'
+    ```
+
 Multiple widgets can be specified by incrementing the index, e.g.
 
 ```yaml