plotly.js 2.7.0 → 2.8.0

package/dist/plot-schema.json

@@ -1202,6 +1202,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -1385,7 +1395,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -1394,6 +1404,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -1491,8 +1505,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -1508,16 +1521,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -1534,16 +1545,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -2494,6 +2503,27 @@
       "valType": "number"
      }
     },
+    "grouptitlefont": {
+     "color": {
+      "editType": "none",
+      "valType": "color"
+     },
+     "description": "Sets the font for group titles in hover (unified modes). Defaults to `hoverlabel.font`.",
+     "editType": "none",
+     "family": {
+      "description": "HTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include *Arial*, *Balto*, *Courier New*, *Droid Sans*,, *Droid Serif*, *Droid Sans Mono*, *Gravitas One*, *Old Standard TT*, *Open Sans*, *Overpass*, *PT Sans Narrow*, *Raleway*, *Times New Roman*.",
+      "editType": "none",
+      "noBlank": true,
+      "strict": true,
+      "valType": "string"
+     },
+     "role": "object",
+     "size": {
+      "editType": "none",
+      "min": 1,
+      "valType": "number"
+     }
+    },
     "namelength": {
      "description": "Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to `namelength - 3` characters and add an ellipsis.",
      "dflt": 15,
@@ -2693,6 +2723,27 @@
       "togglegroup"
      ]
     },
+    "grouptitlefont": {
+     "color": {
+      "editType": "legend",
+      "valType": "color"
+     },
+     "description": "Sets the font for group titles in legend. Defaults to `legend.font` with its size increased about 10%.",
+     "editType": "legend",
+     "family": {
+      "description": "HTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include *Arial*, *Balto*, *Courier New*, *Droid Sans*,, *Droid Serif*, *Droid Sans Mono*, *Gravitas One*, *Old Standard TT*, *Open Sans*, *Overpass*, *PT Sans Narrow*, *Raleway*, *Times New Roman*.",
+      "editType": "legend",
+      "noBlank": true,
+      "strict": true,
+      "valType": "string"
+     },
+     "role": "object",
+     "size": {
+      "editType": "legend",
+      "min": 1,
+      "valType": "number"
+     }
+    },
     "itemclick": {
      "description": "Determines the behavior on legend item click. *toggle* toggles the visibility of the item clicked on the graph. *toggleothers* makes the clicked item the sole visible item on the graph. *false* disables legend item click interactions.",
      "dflt": "toggle",
@@ -12098,6 +12149,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -12281,7 +12342,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -12290,6 +12351,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -12387,8 +12452,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -12404,16 +12468,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -12430,16 +12492,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -13597,6 +13657,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -13780,7 +13850,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -13789,6 +13859,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -13886,8 +13960,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -13903,16 +13976,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -13929,16 +14000,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -17712,6 +17781,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -17895,7 +17974,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -17904,6 +17983,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -18001,8 +18084,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -18018,16 +18100,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -18044,16 +18124,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -18689,6 +18767,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -18872,7 +18960,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -18881,6 +18969,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -18978,8 +19070,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -18995,16 +19086,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -19021,16 +19110,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -19695,6 +19782,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -19878,7 +19975,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -19887,6 +19984,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -19984,8 +20085,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -20001,16 +20101,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -20027,16 +20125,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -20719,6 +20815,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -20902,7 +21008,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -20911,6 +21017,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -21008,8 +21118,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -21025,16 +21134,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -21051,16 +21158,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -21558,11 +21663,40 @@
      "editType": "calc",
      "valType": "data_array"
     },
+    "textfont": {
+     "color": {
+      "dflt": "auto",
+      "editType": "style",
+      "valType": "color"
+     },
+     "description": "For this trace it only has an effect if `coloring` is set to *heatmap*. Sets the text font.",
+     "editType": "plot",
+     "family": {
+      "description": "HTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include *Arial*, *Balto*, *Courier New*, *Droid Sans*,, *Droid Serif*, *Droid Sans Mono*, *Gravitas One*, *Old Standard TT*, *Open Sans*, *Overpass*, *PT Sans Narrow*, *Raleway*, *Times New Roman*.",
+      "editType": "plot",
+      "noBlank": true,
+      "strict": true,
+      "valType": "string"
+     },
+     "role": "object",
+     "size": {
+      "dflt": "auto",
+      "editType": "plot",
+      "min": 1,
+      "valType": "number"
+     }
+    },
     "textsrc": {
      "description": "Sets the source reference on Chart Studio Cloud for `text`.",
      "editType": "none",
      "valType": "string"
     },
+    "texttemplate": {
+     "description": "For this trace it only has an effect if `coloring` is set to *heatmap*. Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example \"Day: %{2019-01-01|%A}\". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `x`, `y`, `z` and `text`.",
+     "dflt": "",
+     "editType": "plot",
+     "valType": "string"
+    },
     "transforms": {
      "items": {
       "transform": {
@@ -22055,6 +22189,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -22238,7 +22382,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -22247,6 +22391,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -22344,8 +22492,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -22361,16 +22508,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -22387,16 +22532,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -22991,6 +23134,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -23174,7 +23327,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -23183,6 +23336,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -23280,8 +23437,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -23297,16 +23453,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -23323,16 +23477,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -24270,6 +24422,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -24453,7 +24615,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -24462,6 +24624,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -24559,8 +24725,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -24576,16 +24741,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -24602,16 +24765,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -25964,6 +26125,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -26147,7 +26318,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -26156,6 +26327,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -26253,8 +26428,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -26270,16 +26444,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -26296,16 +26468,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -26630,11 +26800,40 @@
      "editType": "calc",
      "valType": "data_array"
     },
+    "textfont": {
+     "color": {
+      "dflt": "auto",
+      "editType": "style",
+      "valType": "color"
+     },
+     "description": "Sets the text font.",
+     "editType": "plot",
+     "family": {
+      "description": "HTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include *Arial*, *Balto*, *Courier New*, *Droid Sans*,, *Droid Serif*, *Droid Sans Mono*, *Gravitas One*, *Old Standard TT*, *Open Sans*, *Overpass*, *PT Sans Narrow*, *Raleway*, *Times New Roman*.",
+      "editType": "plot",
+      "noBlank": true,
+      "strict": true,
+      "valType": "string"
+     },
+     "role": "object",
+     "size": {
+      "dflt": "auto",
+      "editType": "plot",
+      "min": 1,
+      "valType": "number"
+     }
+    },
     "textsrc": {
      "description": "Sets the source reference on Chart Studio Cloud for `text`.",
      "editType": "none",
      "valType": "string"
     },
+    "texttemplate": {
+     "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example \"Day: %{2019-01-01|%A}\". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `x`, `y`, `z` and `text`.",
+     "dflt": "",
+     "editType": "plot",
+     "valType": "string"
+    },
     "transforms": {
      "items": {
       "transform": {
@@ -27083,6 +27282,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "calc",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -27266,7 +27475,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "calc",
       "valType": "enumerated",
@@ -27275,6 +27484,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -27372,8 +27585,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -27389,16 +27601,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "calc",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "calc",
       "valType": "enumerated",
       "values": [
@@ -27415,16 +27625,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "calc",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "calc",
       "valType": "enumerated",
       "values": [
@@ -28596,6 +28804,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -28779,7 +28997,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -28788,6 +29006,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -28885,8 +29107,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -28902,16 +29123,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -28928,16 +29147,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -29764,6 +29981,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -29947,7 +30174,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -29956,6 +30183,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -30053,8 +30284,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -30070,16 +30300,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -30096,16 +30324,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -30440,6 +30666,35 @@
       "valType": "string"
      }
     },
+    "textfont": {
+     "color": {
+      "dflt": "auto",
+      "editType": "style",
+      "valType": "color"
+     },
+     "description": "Sets the text font.",
+     "editType": "plot",
+     "family": {
+      "description": "HTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include *Arial*, *Balto*, *Courier New*, *Droid Sans*,, *Droid Serif*, *Droid Sans Mono*, *Gravitas One*, *Old Standard TT*, *Open Sans*, *Overpass*, *PT Sans Narrow*, *Raleway*, *Times New Roman*.",
+      "editType": "plot",
+      "noBlank": true,
+      "strict": true,
+      "valType": "string"
+     },
+     "role": "object",
+     "size": {
+      "dflt": "auto",
+      "editType": "plot",
+      "min": 1,
+      "valType": "number"
+     }
+    },
+    "texttemplate": {
+     "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example \"Day: %{2019-01-01|%A}\". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variable `z`",
+     "dflt": "",
+     "editType": "plot",
+     "valType": "string"
+    },
     "transforms": {
      "items": {
       "transform": {
@@ -30855,6 +31110,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -31038,7 +31303,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -31047,6 +31312,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -31144,8 +31413,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -31161,16 +31429,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -31187,16 +31453,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -31700,6 +31964,35 @@
       "valType": "string"
      }
     },
+    "textfont": {
+     "color": {
+      "dflt": "auto",
+      "editType": "style",
+      "valType": "color"
+     },
+     "description": "For this trace it only has an effect if `coloring` is set to *heatmap*. Sets the text font.",
+     "editType": "plot",
+     "family": {
+      "description": "HTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include *Arial*, *Balto*, *Courier New*, *Droid Sans*,, *Droid Serif*, *Droid Sans Mono*, *Gravitas One*, *Old Standard TT*, *Open Sans*, *Overpass*, *PT Sans Narrow*, *Raleway*, *Times New Roman*.",
+      "editType": "plot",
+      "noBlank": true,
+      "strict": true,
+      "valType": "string"
+     },
+     "role": "object",
+     "size": {
+      "dflt": "auto",
+      "editType": "plot",
+      "min": 1,
+      "valType": "number"
+     }
+    },
+    "texttemplate": {
+     "description": "For this trace it only has an effect if `coloring` is set to *heatmap*. Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example \"Day: %{2019-01-01|%A}\". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `x`, `y`, `z` and `text`.",
+     "dflt": "",
+     "editType": "plot",
+     "valType": "string"
+    },
     "transforms": {
      "items": {
       "transform": {
@@ -32453,6 +32746,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -32636,7 +32939,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -32645,6 +32948,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -32742,8 +33049,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -32759,16 +33065,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -32785,16 +33089,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -34719,6 +35021,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "calc",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -34902,7 +35214,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "calc",
       "valType": "enumerated",
@@ -34911,6 +35223,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -35008,8 +35324,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -35025,16 +35340,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "calc",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "calc",
       "valType": "enumerated",
       "values": [
@@ -35051,16 +35364,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "calc",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "calc",
       "valType": "enumerated",
       "values": [
@@ -35919,6 +36230,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -36102,7 +36423,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -36111,6 +36432,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -36208,8 +36533,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -36225,16 +36549,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -36251,16 +36573,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -37873,6 +38193,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -38056,7 +38386,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -38065,6 +38395,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -38162,8 +38496,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -38179,16 +38512,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -38205,16 +38536,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -38814,6 +39143,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -38997,7 +39336,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -39006,6 +39345,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -39103,8 +39446,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -39120,16 +39462,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -39146,16 +39486,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -42178,6 +42516,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -42361,7 +42709,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -42370,6 +42718,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -42467,8 +42819,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -42484,16 +42835,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -42510,16 +42859,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -44358,6 +44705,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "calc",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -44541,7 +44898,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "calc",
        "valType": "enumerated",
@@ -44550,6 +44907,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -44647,8 +45008,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "calc",
         "valType": "enumerated",
         "values": [
@@ -44664,16 +45024,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -44690,16 +45048,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -44931,6 +45287,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "calc",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -45114,7 +45480,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "calc",
        "valType": "enumerated",
@@ -45123,6 +45489,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -45220,8 +45590,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "calc",
         "valType": "enumerated",
         "values": [
@@ -45237,16 +45606,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -45263,16 +45630,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -46357,6 +46722,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -46540,7 +46915,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -46549,6 +46924,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -46646,8 +47025,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -46663,16 +47041,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -46689,16 +47065,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -48176,6 +48550,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "calc",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -48359,7 +48743,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "calc",
        "valType": "enumerated",
@@ -48368,6 +48752,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -48465,8 +48853,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "calc",
         "valType": "enumerated",
         "values": [
@@ -48482,16 +48869,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -48508,16 +48893,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -50141,6 +50524,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "calc",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -50324,7 +50717,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "calc",
        "valType": "enumerated",
@@ -50333,6 +50726,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -50430,8 +50827,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "calc",
         "valType": "enumerated",
         "values": [
@@ -50447,16 +50843,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -50473,16 +50867,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -52025,6 +52417,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "calc",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -52208,7 +52610,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "calc",
        "valType": "enumerated",
@@ -52217,6 +52619,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -52314,8 +52720,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "calc",
         "valType": "enumerated",
         "values": [
@@ -52331,16 +52736,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -52357,16 +52760,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -53178,6 +53579,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -53361,7 +53772,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -53370,6 +53781,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -53467,8 +53882,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -53484,16 +53898,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -53510,16 +53922,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -55000,6 +55410,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "calc",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -55183,7 +55603,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "calc",
        "valType": "enumerated",
@@ -55192,6 +55612,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -55289,8 +55713,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "calc",
         "valType": "enumerated",
         "values": [
@@ -55306,16 +55729,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -55332,16 +55753,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "calc",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -56799,6 +57218,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -56982,7 +57411,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -56991,6 +57420,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -57088,8 +57521,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -57105,16 +57537,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -57131,16 +57561,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -58624,6 +59052,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -58807,7 +59245,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -58816,6 +59254,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -58913,8 +59355,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -58930,16 +59371,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -58956,16 +59395,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -60403,6 +60840,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -60586,7 +61033,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -60595,6 +61042,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -60692,8 +61143,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -60709,16 +61159,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -60735,16 +61183,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -61786,6 +62232,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "colorbars",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -61969,7 +62425,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "colorbars",
       "valType": "enumerated",
@@ -61978,6 +62434,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -62075,8 +62535,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -62092,16 +62551,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -62118,16 +62575,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "colorbars",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "colorbars",
       "valType": "enumerated",
       "values": [
@@ -63223,6 +63678,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -63406,7 +63871,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -63415,6 +63880,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -63512,8 +63981,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -63529,16 +63997,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -63555,16 +64021,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -64080,6 +64544,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "calc",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -64263,7 +64737,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "calc",
       "valType": "enumerated",
@@ -64272,6 +64746,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -64369,8 +64847,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -64386,16 +64863,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "calc",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "calc",
       "valType": "enumerated",
       "values": [
@@ -64412,16 +64887,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "calc",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "calc",
       "valType": "enumerated",
       "values": [
@@ -66406,6 +66879,16 @@
        "min": 0,
        "valType": "integer"
       },
+      "orientation": {
+       "description": "Sets the orientation of the colorbar.",
+       "dflt": "v",
+       "editType": "colorbars",
+       "valType": "enumerated",
+       "values": [
+        "h",
+        "v"
+       ]
+      },
       "outlinecolor": {
        "description": "Sets the axis line color.",
        "dflt": "#444",
@@ -66589,7 +67072,7 @@
        ]
       },
       "ticklabelposition": {
-       "description": "Determines where tick labels are drawn.",
+       "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
        "dflt": "outside",
        "editType": "colorbars",
        "valType": "enumerated",
@@ -66598,6 +67081,10 @@
         "inside",
         "outside top",
         "inside top",
+        "outside left",
+        "inside left",
+        "outside right",
+        "inside right",
         "outside bottom",
         "inside bottom"
        ]
@@ -66695,8 +67182,7 @@
        },
        "role": "object",
        "side": {
-        "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-        "dflt": "top",
+        "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
         "editType": "colorbars",
         "valType": "enumerated",
         "values": [
@@ -66712,16 +67198,14 @@
        }
       },
       "x": {
-       "description": "Sets the x position of the color bar (in plot fraction).",
-       "dflt": 1.02,
+       "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "xanchor": {
-       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-       "dflt": "left",
+       "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -66738,16 +67222,14 @@
        "valType": "number"
       },
       "y": {
-       "description": "Sets the y position of the color bar (in plot fraction).",
-       "dflt": 0.5,
+       "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
        "editType": "colorbars",
        "max": 3,
        "min": -2,
        "valType": "number"
       },
       "yanchor": {
-       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-       "dflt": "middle",
+       "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
        "editType": "colorbars",
        "valType": "enumerated",
        "values": [
@@ -68686,6 +69168,16 @@
       "min": 0,
       "valType": "integer"
      },
+     "orientation": {
+      "description": "Sets the orientation of the colorbar.",
+      "dflt": "v",
+      "editType": "calc",
+      "valType": "enumerated",
+      "values": [
+       "h",
+       "v"
+      ]
+     },
      "outlinecolor": {
       "description": "Sets the axis line color.",
       "dflt": "#444",
@@ -68869,7 +69361,7 @@
       ]
      },
      "ticklabelposition": {
-      "description": "Determines where tick labels are drawn.",
+      "description": "Determines where tick labels are drawn relative to the ticks. Left and right options are used when `orientation` is *h*, top and bottom when `orientation` is *v*.",
       "dflt": "outside",
       "editType": "calc",
       "valType": "enumerated",
@@ -68878,6 +69370,10 @@
        "inside",
        "outside top",
        "inside top",
+       "outside left",
+       "inside left",
+       "outside right",
+       "inside right",
        "outside bottom",
        "inside bottom"
       ]
@@ -68975,8 +69471,7 @@
       },
       "role": "object",
       "side": {
-       "description": "Determines the location of color bar's title with respect to the color bar. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
-       "dflt": "top",
+       "description": "Determines the location of color bar's title with respect to the color bar. Defaults to *top* when `orientation` if *v* and  defaults to *right* when `orientation` if *h*. Note that the title's location used to be set by the now deprecated `titleside` attribute.",
        "editType": "calc",
        "valType": "enumerated",
        "values": [
@@ -68992,16 +69487,14 @@
       }
      },
      "x": {
-      "description": "Sets the x position of the color bar (in plot fraction).",
-      "dflt": 1.02,
+      "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.",
       "editType": "calc",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "xanchor": {
-      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar.",
-      "dflt": "left",
+      "description": "Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the *left*, *center* or *right* of the color bar. Defaults to *left* when `orientation` is *v* and *center* when `orientation` is *h*.",
       "editType": "calc",
       "valType": "enumerated",
       "values": [
@@ -69018,16 +69511,14 @@
       "valType": "number"
      },
      "y": {
-      "description": "Sets the y position of the color bar (in plot fraction).",
-      "dflt": 0.5,
+      "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.",
       "editType": "calc",
       "max": 3,
       "min": -2,
       "valType": "number"
      },
      "yanchor": {
-      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar.",
-      "dflt": "middle",
+      "description": "Sets this color bar's vertical position anchor This anchor binds the `y` position to the *top*, *middle* or *bottom* of the color bar. Defaults to *middle* when `orientation` is *v* and *bottom* when `orientation` is *h*.",
       "editType": "calc",
       "valType": "enumerated",
       "values": [