From 596bc2c1107545919d25586476f86abee2be5bb1 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 18 Nov 2025 18:02:53 +0100
Subject: [PATCH] DOC: Add example how to align tick labels

Closes #21566.
---
 galleries/examples/ticks/align_ticklabels.py | 32 ++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 galleries/examples/ticks/align_ticklabels.py

diff --git a/galleries/examples/ticks/align_ticklabels.py b/galleries/examples/ticks/align_ticklabels.py
new file mode 100644
index 000000000000..ec36e0db4d07
--- /dev/null
+++ b/galleries/examples/ticks/align_ticklabels.py
@@ -0,0 +1,32 @@
+"""
+=================
+Align tick labels
+=================
+
+By default, tick labels are aligned towards the axis. This means the set of
+*y* tick labels appear right-aligned. Because the alignment reference point
+is on the axis, left-aligned tick labels would overlap the plotting area.
+To achieve a good-looking left-alignment, you have to additionally increase
+the padding.
+"""
+import matplotlib.pyplot as plt
+
+population = {
+    "Sydney": 5.2,
+    "Mexico City": 8.8,
+    "São Paulo": 12.2,
+    "Istanbul": 15.9,
+    "Lagos": 15.9,
+    "Shanghai": 21.9,
+}
+
+fig, ax = plt.subplots(layout="constrained")
+ax.barh(population.keys(), population.values())
+ax.set_xlabel('Population (in millions)')
+
+# left-align all ticklabels
+for ticklabel in ax.get_yticklabels():
+    ticklabel.set_horizontalalignment("left")
+
+# increase padding
+ax.tick_params("y", pad=70)