diff --git a/src/components/shapes/attributes.js b/src/components/shapes/attributes.js
index 99590f4a000..6a6e5a3a846 100644
--- a/src/components/shapes/attributes.js
+++ b/src/components/shapes/attributes.js
@@ -116,7 +116,7 @@ module.exports = templatedArray('shape', {
         description: [
             'Specifies whether shapes are drawn below gridlines (*below*),',
             'between gridlines and traces (*between*) or above traces (*above*).'
-        ]
+        ].join(' ')
     },
 
     xref: extendFlat({}, annAttrs.xref, {
diff --git a/src/components/shapes/draw_newshape/attributes.js b/src/components/shapes/draw_newshape/attributes.js
index bacd6e07504..633870414b6 100644
--- a/src/components/shapes/draw_newshape/attributes.js
+++ b/src/components/shapes/draw_newshape/attributes.js
@@ -122,7 +122,7 @@ module.exports = overrideAll({
             description: [
                 'Specifies whether new shapes are drawn below gridlines (*below*),',
                 'between gridlines and traces (*between*) or above traces (*above*).'
-            ]
+            ].join(' ')
         },
         drawdirection: {
             valType: 'enumerated',
diff --git a/test/plot-schema.json b/test/plot-schema.json
index 9ff3ae08540..4ce7600457d 100644
--- a/test/plot-schema.json
+++ b/test/plot-schema.json
@@ -3720,10 +3720,7 @@
      }
     },
     "layer": {
-     "description": [
-      "Specifies whether new shapes are drawn below gridlines (*below*),",
-      "between gridlines and traces (*between*) or above traces (*above*)."
-     ],
+     "description": "Specifies whether new shapes are drawn below gridlines (*below*), between gridlines and traces (*between*) or above traces (*above*).",
      "dflt": "above",
      "editType": "none",
      "valType": "enumerated",
@@ -7712,10 +7709,7 @@
        }
       },
       "layer": {
-       "description": [
-        "Specifies whether shapes are drawn below gridlines (*below*),",
-        "between gridlines and traces (*between*) or above traces (*above*)."
-       ],
+       "description": "Specifies whether shapes are drawn below gridlines (*below*), between gridlines and traces (*between*) or above traces (*above*).",
        "dflt": "above",
        "editType": "arraydraw",
        "valType": "enumerated",