20

I created 3 subplots using subplot(). Now I'd like to add titles for each subplot. Which one of title() and suptitle() shall I use?

In general, what is the difference between them?

1
  • I think title applies to a specific axis within the figure, whereas suptitle applies to the whole figure (and all axes within it)
    – Jake Levi
    Commented Sep 4, 2022 at 12:04

1 Answer 1

19

You can set the main figure title with fig.suptitle and subplot's titles with ax.set_title or by passing title to fig.add_subplot. For example:

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(-np.pi, np.pi, 0.01)

fig = plt.figure()
fig.suptitle('Main figure title')

ax1 = fig.add_subplot(311, title='Subplot 1 title')
ax1.plot(x, np.sin(x))

ax2 = fig.add_subplot(312)
ax2.set_title('Subplot 2 title')
ax2.plot(x, np.cos(x))

ax3 = fig.add_subplot(313)
ax3.set_title('Subplot 3 title')
ax3.plot(x, np.tan(x))

plt.show()

enter image description here

(You may need to manually tweak the font sizes to get the styling you want). I think subtitles need special placement and sizing of the text. For example, see Giving graphs a subtitle in matplotlib

4
  • 4
    Thanks for the concrete example. I misread suptitle() to subtitle(). Now it makes sense.
    – pyan
    Commented May 7, 2015 at 19:19
  • See also the methods matplotlib.pyplot.title and matplotlib.pyplot.suptitle.
    – michen00
    Commented Sep 29, 2021 at 20:11
  • 2
    It looks like the "sup" in "suptitle" might stand for super.
    – Alper
    Commented Aug 17, 2022 at 15:33
  • 2
    suptitle is one of the most nasty attribute names you ever met.
    – Kuo
    Commented Jun 15 at 7:57

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.