Plot types
Examples
Tutorials
Reference
User guide
Develop
Release notes

gitter
discourse
GitHub
twitter

Behavior Change template
Improved autoscaling for bezier curves
Large imshow images are now downsampled
Incompatible layout engines raise
Type1Font objects include more properties
3D contourf polygons placed between levels
rcParams.copy() returns a new RcParams instance, rather than a dict
CallbackRegistry raises on unknown signals
FigureFrameWx constructor, subclasses, and get_canvas
FigureFrameWx.sizer
Move Axes title to not overlap with y axis offset
MathtextBackendAgg.get_results no longer returns used_characters
ArtistList proxies copy contents on iteration
AxesImage string representation
New algorithm keyword argument to contour and contourf
MacOSX backend to use sRGB instead of GenericRGB colorspace
QuadMesh mouseover defaults to False
No need to specify renderer for get_tightbbox and get_window_extent
The encoding of style file is now specified to be utf-8
get_ticklabels now always populates labels
Default date limits changed to 1970-01-01 to 1970-01-02
The math parameter of mathtext.get_unicode_index is deprecated and defaults to False
Template for deprecations
axes_size internal helpers
Selector widget state internals
backend_gtk3.icon_filename and backend_gtk3.window_icon
Calling MarkerStyle() with no arguments or MarkerStyle(None)
backend_gtk3.error_msg_gtk and backend_wx.error_msg_wx
In the future, dviread.find_tex_file will raise a FileNotFoundError for missing files
backend_svg.generate_transform and backend_svg.generate_css
3D Axis
Modifications to the Groupers returned by get_shared_x_axes and get_shared_y_axes
backend_pgf
transOffset parameter name
RendererGTK3Cairo and RendererGTK4Cairo
FigureManagerGTK3Agg and FigureManagerGTK4Agg
lastrect
ImageMagickBase.delay and ImageMagickBase.output_args
NavigationToolbar2GTK3 window
FigureFrameWx attributes and methods
FigureCanvasBase.resize
FigureCanvas without a required_interactive_framework attribute
Axes3D.dist
AxisArtistHelper.delta1 and AxisArtistHelper.delta2
axes_grid and axisartist removals
Axes.get_window_extent and Figure.get_window_extent won't accept parameters other than renderer anymore
AFM , configfont_pattern and Type1Font deprecated
Modules tight_bbox and tight_layout deprecated
Module docstring deprecated
Selector widget state internals
cleared parameter of get_renderer
ticker functions deprecated
cmap_d removal
seaborn styles renamed
matplotlib.cbook.maxdict is deprecated
Pending deprecation of layout methods
emit and auto parameters of set_xlim , set_ylim , set_zlim , set_rlim
Auto-removal of overlapping Axes by plt.subplot and plt.subplot2grid
Parameters to plt.figure() and the Figure constructor
backend_ps.convert_psfrags
Affine2D.identity()
backend_qt.qApp
ToolBase.destroy
matplotlib.text.get_rotation()
TextToPath.get_texmanager
_DummyAxis.dataLim and _DummyAxis.viewLim
Deprecations in testing.decorators
TexManager.get_font_config
Deprecation of helper functions in backends
figure.callbacks is deprecated
Passing too many positional arguments to tripcolor
backend_pdf.Operator and backend_pdf.Op.op
Methods to set parameters in LogLocator and LogFormatter*
checkdep_usetex deprecated
date_ticker_factory deprecated
Positional arguments in Artist constructors
Unused methods in Axis , Tick , XAxis , and YAxis
Passing linefmt positionally is undeprecated
backend_pdf.Name.hexify
stem(..., use_line_collection=False)
mlab.stride_windows
Development Change template
gui_support.macosx setup option has been renamed to packages.macosx
Increase to minimum supported versions of Python and dependencies
sphinx>=3.0 and numpydoc>=1.0 are now required for building the docs
Removal Change template
Removal of mplot3d deprecations
Support for passing tool names to ToolManager.add_tool
Unknown keyword arguments to savefig and FigureCanvas.print_foo methods
backend_tools.ToolFullScreen now inherits from ToolBase , not from ToolToggleBase
Removed loaded modules logging
colorbar defaults to stealing space from the mappable's axes rather than the current axes
Removal of deprecated mathtext APIs
Removal of deprecated MovieWriter.cleanup
mpl_toolkits.axes_grid1.axes_size.AddList
Removal of deprecated methods and properties in lines and patches
Removal of deprecations in cbook
Removal of deprecations in backends
Removal of deprecated methods in matplotlib.projections.polar
mpl_toolkits.axes_grid module removed
MarkerStyle is immutable
Passing positional arguments to LineCollection has been removed
Keyword arguments to gca() have been removed
Axis.cla() has been removed
key_press and button_press have been removed from FigureManager
Get/set window title methods have been removed from the canvas
BoxStyle._Base and transmute method of boxstyles

Next API changes#

Created using Sphinx 5.0.2.