Version 2.2.2
Fork me on GitHub

Table Of Contents


matplotlib.pyplot.yticks(*args, **kwargs)

Get or set the current tick locations and labels of the y-axis.

Call signatures:

locs, labels = yticks()           # Get locations and labels

yticks(locs, [labels], **kwargs)  # Set locations and labels

locs : array_like

A list of positions at which ticks should be placed. You can pass an empty list to disable yticks.

labels : array_like, optional

A list of explicit labels to place at the given locs.


Text properties can be used to control the appearance of the labels.



An array of label locations.


A list of Text objects.


Calling this function with no arguments (e.g. yticks()) is the pyplot equivalent of calling get_yticks and get_yticklabels on the current axes. Calling this function with arguments is the pyplot equivalent of calling set_yticks and set_yticklabels on the current axes.


Get the current locations and labels:

>>> locs, labels = yticks()

Set label locations:

>>> yticks(np.arange(0, 1, step=0.2))

Set text labels:

>>> yticks(np.arange(5), ('Tom', 'Dick', 'Harry', 'Sally', 'Sue'))

Set text labels and properties:

>>> yticks(np.arange(12), calendar.month_name[1:13], rotation=45)

Disable yticks:

>>> yticks([])