diff --git a/doc/python/axes.md b/doc/python/axes.md
index eea8f8daed7..cdab606651e 100644
--- a/doc/python/axes.md
+++ b/doc/python/axes.md
@@ -741,6 +741,27 @@ fig.update_yaxes(domain=(0.25, 0.75))
 fig.show()
 ```
 
+#### Synchronizing axes in subplots with `matches`
+
+Using `facet_col` from `plotly.express` let [zoom](https://help.plot.ly/zoom-pan-hover-controls/#step-3-zoom-in-and-zoom-out-autoscale-the-plot) and [pan](https://help.plot.ly/zoom-pan-hover-controls/#step-6-pan-along-axes) each facet to the same range implicitly. However, if the subplots are created with `make_subplots`, the axis needs to be updated with `matches` parameter to update all the subplots accordingly. 
+
+Zoom in one trace below, to see the other subplots zoomed to the same x-axis range. To pan all the subplots, click and drag from the center of x-axis to the side:
+
+```python
+import plotly.graph_objects as go
+from plotly.subplots import make_subplots
+import numpy as np
+
+N = 20
+x = np.linspace(0, 1, N)
+
+fig = make_subplots(1, 3)
+for i in range(1, 4):
+    fig.add_trace(go.Scatter(x=x, y=np.random.random(N)), 1, i)
+fig.update_xaxes(matches='x')
+fig.show()
+```
+
 #### Reference
 
 See https://plot.ly/python/reference/#layout-xaxis and https://plot.ly/python/reference/#layout-yaxis for more information and chart attribute options!