Matplotlib.figure.Figure.suptitle() in Python

Last Updated : 12 Jul, 2025

Matplotlib is a library in Python and it is numerical – mathematical extension for NumPy library. The figure module provides the top-level Artist, the Figure, which contains all the plot elements. This module is used to control the default spacing of the subplots and top level container for all plot elements.

matplotlib.figure.Figure.suptitle() method

The suptitle() method figure module of matplotlib library is used to Add a centered title to the figure.

Syntax: suptitle(self, t, **kwargs) Parameters: This method accept the following parameters that are discussed below:

t : This parameter is the title text.

x: This parameter is the x location of the text in figure coordinates.

y: This parameter is the y location of the text in figure coordinates.

horizontalalignment, ha : This parameter is the horizontal alignment of the text relative to (x, y).

verticalalignment, va : This parameter is the vertical alignment of the text relative to (x, y).

fontsize, size : This parameter is the font size of the text.

fontweight, weight : This parameter is the font weight of the text.

Returns: This method returns the Text instance of the title.

Below examples illustrate the matplotlib.figure.Figure.suptitle() function in matplotlib.figure: Example 1:

Python3 1==

# Implementation of matplotlib function
import matplotlib.pyplot as plt
import numpy as np
import matplotlib.gridspec as gridspec
 

fig = plt.figure(tight_layout = True)
gs = gridspec.GridSpec(1, 1)
 
ax = fig.add_subplot(gs[0, :])
ax.plot(np.arange(0, 1e6, 1000))
ax.set_ylabel('YLabel0')
ax.set_xlabel('XLabel0')
 
fig.suptitle('matplotlib.figure.Figure.suptitle()\
 function Example\n\n', fontweight ="bold")

plt.show()

Output:

Example 2:

Python3 1==

# Implementation of matplotlib function
import matplotlib.pyplot as plt
import numpy as np

  
np.random.seed(19680801)
 
xdata = np.random.random([2, 10])
 
xdata1 = xdata[0, :]
xdata2 = xdata[1, :]
 
ydata1 = xdata1 ** 2
ydata2 = 1 - xdata2 ** 3
  
fig = plt.figure()
ax = fig.add_subplot(1, 1, 1)
ax.plot(xdata1, ydata1, color ='tab:blue')
ax.plot(xdata2, ydata2, color ='tab:orange')
  
ax.set_xlim([0, 1])
ax.set_ylim([0, 1])

fig.suptitle('matplotlib.figure.Figure.suptitle()\
 function Example\n\n', fontweight ="bold")

plt.show()