How to Fix Overlapping Labels in Matplotlib Plots

To fix overlapping labels in matplotlib, you can rotate the labels using plt.xticks(rotation=angle) or use plt.tight_layout() to automatically adjust spacing. Another option is to use fig.autofmt_xdate() for date labels to improve readability.

Why This Happens

Labels overlap in Matplotlib when there is not enough space to display them clearly. This often happens with many labels or long text on the x-axis or y-axis. The default layout does not automatically adjust spacing, so labels can collide and become unreadable.

python

import matplotlib.pyplot as plt

labels = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August']
values = [5, 7, 3, 8, 6, 9, 4, 7]

plt.bar(labels, values)
plt.show()

Output

A bar chart with x-axis labels overlapping and hard to read.

The Fix

Rotate the labels to make them fit better and use plt.tight_layout() to adjust the plot spacing automatically. Rotating labels at 45 or 90 degrees often solves overlap issues.

python

import matplotlib.pyplot as plt

labels = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August']
values = [5, 7, 3, 8, 6, 9, 4, 7]

plt.bar(labels, values)
plt.xticks(rotation=45)
plt.tight_layout()
plt.show()

Output

A bar chart with x-axis labels rotated 45 degrees and spaced properly for clear reading.

Prevention

To avoid overlapping labels in future plots, always consider label length and number before plotting. Use rotation for long labels, plt.tight_layout() to adjust spacing, and limit the number of ticks if possible. For date labels, use fig.autofmt_xdate() to format automatically.

Related Errors

Other common label issues include labels being cut off or clipped. These can be fixed by increasing figure size with plt.figure(figsize=(width, height)) or adjusting margins with plt.subplots_adjust().

Key Takeaways

Rotate axis labels using plt.xticks(rotation=angle) to prevent overlap.

Use plt.tight_layout() to automatically adjust plot spacing.

Limit the number of ticks or shorten label text when possible.

For date labels, use fig.autofmt_xdate() for better formatting.

Increase figure size or adjust margins to avoid label clipping.