diff --git a/tools/docs/schema.ts b/tools/docs/schema.ts
index f02b13632e..293e713af9 100644
--- a/tools/docs/schema.ts
+++ b/tools/docs/schema.ts
@@ -91,9 +91,21 @@ function addChildrenArrayInParents(): void {
               type: 'object',
               properties: {
                 description: {
-                  type: 'string',
-                  description:
-                    'A custom description for this configuration object',
+                  oneOf: [
+                    {
+                      type: 'array',
+                      items: {
+                        type: 'string',
+                        description:
+                          'A custom description for this configuration object',
+                      },
+                    },
+                    {
+                      type: 'string',
+                      description:
+                        'A custom description for this configuration object',
+                    },
+                  ],
                 },
               },
             },