You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Applications are open for the 2018 John Hunter Matplotlib Summer Fellowship. Apply now!
Version 2.2.2.post1695+gedd053d16
Fork me on GitHub

Table Of Contents


Axes.set_title(label, fontdict=None, loc='center', pad=None, **kwargs)[source]

Set a title for the axes.

Set one of the three available axes titles. The available titles are positioned above the axes in the center, flush with the left edge, and flush with the right edge.

label : str

Text to use for the title

fontdict : dict

A dictionary controlling the appearance of the title text, the default fontdict is:

{'fontsize': rcParams['axes.titlesize'],
 'fontweight' : rcParams['axes.titleweight'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}
loc : {'center', 'left', 'right'}, str, optional

Which title to set, defaults to 'center'

pad : float

The offset of the title from the top of the axes, in points. Default is None to use rcParams['axes.titlepad'].

text : Text

The matplotlib text instance representing the title

Other Parameters:
**kwargs : Text properties

Other keyword arguments are text properties, see Text for a list of valid text properties.