plotly · emilykl · Jan 6, 2026 · Jan 6, 2026 · Jan 8, 2026 · Jan 19, 2026
diff --git a/draftlogs/7684_change.md b/draftlogs/7684_change.md
@@ -0,0 +1 @@
+ - Set default layout.axis.tickmode to 'sync' when axis is overlaying [[#7684](https://github.com/plotly/plotly.js/pull/7684)]
diff --git a/src/plots/cartesian/dragbox.js b/src/plots/cartesian/dragbox.js
@@ -732,7 +732,10 @@ function makeDragBox(gd, plotinfo, x, y, w, h, ns, ew) {
             for(i = 0; i < axList.length; i++) {
                 var axListI = axList[i];
                 var axListIType = axListI[axisType];
-                if(!axListI.fixedrange && axListIType.tickmode === 'sync') activeAxIds.push(axListIType._id);
+                var axId = axListIType._id;
+                if(!axListI.fixedrange && axListIType.tickmode === 'sync' && !activeAxIds.includes(axId)) {
+                    activeAxIds.push(axId);
+                }
             }
         }
 

diff --git a/src/plots/cartesian/layout_attributes.js b/src/plots/cartesian/layout_attributes.js
@@ -35,7 +35,8 @@ var tickmode = extendFlat({}, minorTickmode, {
     description: [
         minorTickmode.description,
         'If *sync*, the number of ticks will sync with the overlayed axis',
-        'set by `overlaying` property.'
+        'set by `overlaying` property. When no other tick info is provided,',
+        'overlaying (non-categorical) axes default to *sync*, while other axes default to *auto*.',
     ].join(' ')
 });
 

diff --git a/src/plots/cartesian/tick_value_defaults.js b/src/plots/cartesian/tick_value_defaults.js
@@ -5,44 +5,48 @@ var isArrayOrTypedArray = require('../../lib').isArrayOrTypedArray;
 var isTypedArraySpec = require('../../lib/array').isTypedArraySpec;
 var decodeTypedArraySpec = require('../../lib/array').decodeTypedArraySpec;
 
-module.exports = function handleTickValueDefaults(containerIn, containerOut, coerce, axType, opts) {
-    if(!opts) opts = {};
+module.exports = function handleTickValueDefaults(containerIn, containerOut, coerce, axType, opts = {}) {
     var isMinor = opts.isMinor;
     var cIn = isMinor ? containerIn.minor || {} : containerIn;
     var cOut = isMinor ? containerOut.minor : containerOut;
     var prefix = isMinor ? 'minor.' : '';
 
     function readInput(attr) {
         var v = cIn[attr];
-        if(isTypedArraySpec(v)) v = decodeTypedArraySpec(v);
+        if (isTypedArraySpec(v)) v = decodeTypedArraySpec(v);
 
-        return (
-            v !== undefined
-        ) ? v : (cOut._template || {})[attr];
+        return v !== undefined ? v : (cOut._template || {})[attr];
     }
 
     var _tick0 = readInput('tick0');
     var _dtick = readInput('dtick');
     var _tickvals = readInput('tickvals');
+    var _overlaying = readInput('overlaying');
+    var _categorical = axType === 'category' || axType === 'multicategory';
 
-    var tickmodeDefault = isArrayOrTypedArray(_tickvals) ? 'array' :
-        _dtick ? 'linear' :
-        'auto';
+    var tickmodeDefault;
+    if (isArrayOrTypedArray(_tickvals)) {
+        tickmodeDefault = 'array';
+    } else if (_dtick) {
+        tickmodeDefault = 'linear';
+    } else if (_overlaying && !_categorical) {
+        tickmodeDefault = 'sync';
+    } else {
+        tickmodeDefault = 'auto';
+    }
     var tickmode = coerce(prefix + 'tickmode', tickmodeDefault);
 
-    if(tickmode === 'auto' || tickmode === 'sync') {
+    if (tickmode === 'auto' || tickmode === 'sync') {
         coerce(prefix + 'nticks');
-    } else if(tickmode === 'linear') {
+    } else if (tickmode === 'linear') {
         // dtick is usually a positive number, but there are some
         // special strings available for log or date axes
         // tick0 also has special logic
-        var dtick = cOut.dtick = cleanTicks.dtick(
-            _dtick, axType);
-        cOut.tick0 = cleanTicks.tick0(
-            _tick0, axType, containerOut.calendar, dtick);
-    } else if(axType !== 'multicategory') {
+        var dtick = (cOut.dtick = cleanTicks.dtick(_dtick, axType));
+        cOut.tick0 = cleanTicks.tick0(_tick0, axType, containerOut.calendar, dtick);
+    } else if (axType !== 'multicategory') {
         var tickvals = coerce(prefix + 'tickvals');
-        if(tickvals === undefined) cOut.tickmode = 'auto';
-        else if(!isMinor) coerce('ticktext');
+        if (tickvals === undefined) cOut.tickmode = 'auto';
+        else if (!isMinor) coerce('ticktext');
     }
 };
diff --git a/test/image/baselines/20.png b/test/image/baselines/20.png
diff --git a/test/image/baselines/autorange-tozero-rangemode.png b/test/image/baselines/autorange-tozero-rangemode.png
diff --git a/test/image/baselines/candlestick_double-y-axis.png b/test/image/baselines/candlestick_double-y-axis.png
diff --git a/test/image/baselines/candlestick_rangeslider_thai.png b/test/image/baselines/candlestick_rangeslider_thai.png
diff --git a/test/image/baselines/gl2d_multiple-traces-axes.png b/test/image/baselines/gl2d_multiple-traces-axes.png
diff --git a/test/image/baselines/insiderange-x-multi-y.png b/test/image/baselines/insiderange-x-multi-y.png
diff --git a/test/image/baselines/insiderange-y-multi-x.png b/test/image/baselines/insiderange-y-multi-x.png
diff --git a/test/image/baselines/legend_scroll_beyond_plotarea.png b/test/image/baselines/legend_scroll_beyond_plotarea.png
diff --git a/test/image/baselines/legend_visibility.png b/test/image/baselines/legend_visibility.png
diff --git a/test/image/baselines/mult-yaxes-manual-shift.png b/test/image/baselines/mult-yaxes-manual-shift.png
diff --git a/test/image/baselines/mult-yaxes-redraw.png b/test/image/baselines/mult-yaxes-redraw.png
diff --git a/test/image/baselines/mult-yaxes-simple.png b/test/image/baselines/mult-yaxes-simple.png
diff --git a/test/image/baselines/mult-yaxes-subplots-stacked.png b/test/image/baselines/mult-yaxes-subplots-stacked.png
diff --git a/test/image/baselines/multicategory_series.png b/test/image/baselines/multicategory_series.png
diff --git a/test/image/baselines/multiple_axes_double.png b/test/image/baselines/multiple_axes_double.png
diff --git a/test/image/baselines/multiple_axes_multiple.png b/test/image/baselines/multiple_axes_multiple.png
diff --git a/test/image/baselines/overlaying-axis-lines.png b/test/image/baselines/overlaying-axis-lines.png
diff --git a/test/image/baselines/range_slider_axes_double.png b/test/image/baselines/range_slider_axes_double.png
diff --git a/test/image/baselines/range_slider_legend_left.png b/test/image/baselines/range_slider_legend_left.png
diff --git a/test/image/baselines/ticklabelposition-overlay.png b/test/image/baselines/ticklabelposition-overlay.png
diff --git a/test/image/baselines/ticklabelposition-overlay2.png b/test/image/baselines/ticklabelposition-overlay2.png
diff --git a/test/image/baselines/yaxis-over-yaxis2.png b/test/image/baselines/yaxis-over-yaxis2.png
diff --git a/test/image/baselines/zorder-overlayed-subplots-multiple-traces-main-subplot.png b/test/image/baselines/zorder-overlayed-subplots-multiple-traces-main-subplot.png
diff --git a/test/image/baselines/zorder-overlayed-subplots-multiple-traces-main-subplot2.png b/test/image/baselines/zorder-overlayed-subplots-multiple-traces-main-subplot2.png
diff --git a/test/image/baselines/zorder-overlayed-subplots-multiple-traces-one-subplot.png b/test/image/baselines/zorder-overlayed-subplots-multiple-traces-one-subplot.png
diff --git a/test/image/baselines/zorder-overlayed-subplots.png b/test/image/baselines/zorder-overlayed-subplots.png
diff --git a/test/image/baselines/zzz_zerolinelayer_above.png b/test/image/baselines/zzz_zerolinelayer_above.png
diff --git a/test/image/baselines/zzz_zerolinelayer_below.png b/test/image/baselines/zzz_zerolinelayer_below.png
diff --git a/test/image/mocks/shapes_layer_below_traces.json b/test/image/mocks/shapes_layer_below_traces.json
@@ -103,7 +103,8 @@
     "yaxis2": {
       "gridwidth": 2,
       "side": "right",
-      "overlaying": "y"
+      "overlaying": "y",
+      "tickmode": "auto"
     }
   }
 }
diff --git a/test/plot-schema.json b/test/plot-schema.json
@@ -14833,7 +14833,7 @@
           "valType": "number"
         },
         "tickmode": {
-          "description": "Sets the tick mode for this axis. If *auto*, the number of ticks is set via `nticks`. If *linear*, the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` (*linear* is the default value if `tick0` and `dtick` are provided). If *array*, the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. (*array* is the default value if `tickvals` is provided). If *sync*, the number of ticks will sync with the overlayed axis set by `overlaying` property.",
+          "description": "Sets the tick mode for this axis. If *auto*, the number of ticks is set via `nticks`. If *linear*, the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` (*linear* is the default value if `tick0` and `dtick` are provided). If *array*, the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. (*array* is the default value if `tickvals` is provided). If *sync*, the number of ticks will sync with the overlayed axis set by `overlaying` property. When no other tick info is provided, overlaying (non-categorical) axes default to *sync*, while other axes default to *auto*.",
           "editType": "ticks",
           "impliedEdits": {},
           "valType": "enumerated",
@@ -16112,7 +16112,7 @@
           "valType": "number"
         },
         "tickmode": {
-          "description": "Sets the tick mode for this axis. If *auto*, the number of ticks is set via `nticks`. If *linear*, the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` (*linear* is the default value if `tick0` and `dtick` are provided). If *array*, the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. (*array* is the default value if `tickvals` is provided). If *sync*, the number of ticks will sync with the overlayed axis set by `overlaying` property.",
+          "description": "Sets the tick mode for this axis. If *auto*, the number of ticks is set via `nticks`. If *linear*, the placement of the ticks is determined by a starting position `tick0` and a tick step `dtick` (*linear* is the default value if `tick0` and `dtick` are provided). If *array*, the placement of the ticks is set via `tickvals` and the tick text is `ticktext`. (*array* is the default value if `tickvals` is provided). If *sync*, the number of ticks will sync with the overlayed axis set by `overlaying` property. When no other tick info is provided, overlaying (non-categorical) axes default to *sync*, while other axes default to *auto*.",
           "editType": "ticks",
           "impliedEdits": {},
           "valType": "enumerated",
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		- Set default layout.axis.tickmode to 'sync' when axis is overlaying [[#7684](https://github.com/plotly/plotly.js/pull/7684)]