Update multiple-axes.md

Author: LiamConnors

Diff for: doc/python/multiple-axes.md

@@ -8,7 +8,7 @@ jupyter:
       format_version: '1.3'
       jupytext_version: 1.14.1
   kernelspec:
-    display_name: Python 3
+    display_name: Python 3 (ipykernel)
     language: python
     name: python3
   language_info:
@@ -20,7 +20,7 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.8.8
+    version: 3.8.0
   plotly:
     description: How to make a graph with multiple axes (dual y-axis plots, plots
       with secondary axes) in python.
@@ -249,5 +249,106 @@ fig.update_layout(
 fig.show()
 ```
 
+#### Automatically Shifting Axes
+
+To automatically reposition axes to avoid overlap with other axes with the same `overlaying` value, set `autoshift=True`. For `autoshift` to work on an axis, you'll also need to set `anchor="free"` on that axis.
+
+```python
+import plotly.graph_objects as go
+
+fig = go.Figure()
+
+fig.add_trace(go.Scatter(x=[1, 2, 3], y=[4, 5, 6], name="yaxis data"))
+
+
+fig.add_trace(go.Scatter(x=[2, 3, 4], y=[40, 50, 60], name="yaxis2 data", yaxis="y2"))
+
+fig.add_trace(
+    go.Scatter(x=[4, 5, 6], y=[1000, 2000, 3000], name="yaxis3 data", yaxis="y3")
+)
+
+fig.add_trace(
+    go.Scatter(x=[3, 4, 5], y=[400, 500, 600], name="yaxis4 data", yaxis="y4")
+)
+
+
+fig.update_layout(
+    xaxis=dict(domain=[0.25, 0.75]),
+    yaxis=dict(
+        title="yaxis title",
+    ),
+    yaxis2=dict(
+        title="yaxis2 title",
+        overlaying="y",
+        side="right",
+    ),
+    yaxis3=dict(title="yaxis3 title", anchor="free", overlaying="y", autoshift=True),
+    yaxis4=dict(
+        title="yaxis4 title",
+        anchor="free",
+        overlaying="y",
+        autoshift=True,
+    ),
+)
+
+fig.update_layout(
+    title_text="Shifting y-axes with autoshift",
+)
+
+fig.show()
+
+```
+
+### Shift Axes by a Specific Number of Pixels
+
+Set a `shift` value on an axis to shift an axis by that number of pixels. A positive value shifts an axis to the right. A negative value shifts it to the left. Here, we shift `yaxis4` 100 pixels further to the left.
+
+```python
+import plotly.graph_objects as go
+
+fig = go.Figure()
+
+fig.add_trace(go.Scatter(x=[1, 2, 3], y=[4, 5, 6], name="yaxis data"))
+
+
+fig.add_trace(go.Scatter(x=[2, 3, 4], y=[40, 50, 60], name="yaxis2 data", yaxis="y2"))
+
+fig.add_trace(
+    go.Scatter(x=[4, 5, 6], y=[1000, 2000, 3000], name="yaxis3 data", yaxis="y3")
+)
+
+fig.add_trace(
+    go.Scatter(x=[3, 4, 5], y=[400, 500, 600], name="yaxis4 data", yaxis="y4")
+)
+
+
+fig.update_layout(
+    xaxis=dict(domain=[0.25, 0.75]),
+    yaxis=dict(
+        title="yaxis title",
+    ),
+    yaxis2=dict(
+        title="yaxis2 title",
+        overlaying="y",
+        side="right",
+    ),
+    yaxis3=dict(title="yaxis3 title", anchor="free", overlaying="y", autoshift=True),
+    yaxis4=dict(
+        title="yaxis4 title",
+        anchor="free",
+        overlaying="y",
+        autoshift=True,
+        shift=-100,
+    ),
+)
+
+fig.update_layout(
+    title_text="Shifting y-axes by a specific number of pixels",
+)
+
+fig.show()
+
+```
+
 #### Reference
 All of the y-axis properties are found here: https://plotly.com/python/reference/YAxis/.  For more information on creating subplots see the [Subplots in Python](/python/subplots/) section.