MatrixPlot.legend(*, show=True, title='Expression\\nlevel in group', width=1.5)[source]#

Configure legend parameters

show bool | None (default: True)

Set to ‘False’ to hide the default plot of the legend. This sets the legend width to zero which will result in a wider main plot.

title str | None (default: 'Expression\\nlevel in group')

Legend title. Appears on top of the color bar. Use ‘\n’ to add line breaks.

width float | None (default: 1.5)

Width of the legend. The unit is the same as in matplotlib (inches)

Return type:



Returns self for method chaining.


Set legend title:

>>> import scanpy as sc
>>> adata = sc.datasets.pbmc68k_reduced()
>>> markers = {'T-cell': 'CD3D', 'B-cell': 'CD79A', 'myeloid': 'CST3'}
>>> dp =, markers, groupby='bulk_labels') \
...     .legend(title='log(UMI counts + 1)')
>>> dp.color_legend_title
'log(UMI counts + 1)'