v6.6.0

Compare Source

Fixed

• Remove unneeded type="text/javascript" attribute from <style> tag [#​5454], with thanks to @​hannob for the contribution!
• Remove global warning format side effect [#​5481], with thanks to @​emmanuel-ferdman for the contribution!
• Fix spurious engine deprecation warning in write_image [#​5517], with thanks to @​mosh3eb for the contribution!

Updated

• Update plotly.js from version 3.3.1 to version 3.4.0. See the plotly.js release notes for more information. [#​5527]. Notable changes include:
  • Add support for clicking legend titles to toggle visibility of all traces in legend [#​7698]
  • Add support for shapes to reference multiple axes [#​7666]
  • Add support for dashed marker lines in scatter plots [#​7673]
  • Increase axis autorange when bar charts have outside text labels, to avoid labels being clipped [#​7675]

v6.5.2

Compare Source

Fixed

• Fix issue where pie trace legend, showlegend attributes don't accept array values [#​5464 and #​5465], with thanks to @​my-tien for the contribution!

v6.5.1

Compare Source

Fixed

• Fix issue where Plotly Express ignored trace-specific color sequences defined in templates via template.data.<trace_type> [#​5437], with thanks to @​antonymilne for the contribution!

Updated

• Speed up validate_gantt function [#​5386], with thanks to @​misrasaurabh1 for the contribution!
• Update plotly.js from version 3.3.0 to version 3.3.1. See the plotly.js release notes for more information. [#​5456]. Notable changes include:
  • Add support for arrays for the pie properties showlegend and legend, so that these can be configured per slice. [#​7580]

v6.5.0

Compare Source

Updated

• Update plotly.js from version 3.2.0 to version 3.3.0. See the plotly.js release notes for more information. [#​5421]. Notable changes include:
  • Add hovertemplate for candlestick and ohlc traces [#​7619]

Fixed

• Fix bug where numpy datetime contained in Python list was converted to integer [#​5415]

v6.4.0

Compare Source

Updated

• Update plotly.js from version 3.1.1 to version 3.2.0. See the plotly.js release notes for more information. [#​5357]. Notable changes include:
  • Add hovertemplatefallback and texttemplatefallback attributes [#​7577]
  • Add "SI extended" formatting rule for tick exponents on axis labels, allowing values to be displayed with extended SI prefixes (e.g., femto, pico, atto) [#​7249]

Deprecated

• Deprecate create_hexbin_mapbox in favor of create_hexbin_map, update related function calls [5358], with thanks to @​ajlien for the contribution!

v6.3.1

Compare Source

Updated

• Update Plotly.js from version 3.1.0 to version 3.1.1. See the Plotly.js release notes for more information. [#​5357]. Notable changes include:
  • Fix issue preventing Scattergl plots with text elements from rendering [plotly.js#7563]
• Use native legends when converting from matplotlib [#​5312], with thanks to @​robertoffmoura to the contribution!
• Allow shared_yaxes to work with secondary axes [#​5180], with thanks to @​gmjw for the contribution!

Fixed

• Fix issue where width/height in plot layout were not respected during Kaleido image export [#​5325]
• Fix typo in default argument to _ternary_contour.py [#​5315], with thanks to @​Lexachoc for the contribution!
• Fix incorrect fig.show() behavior when ipython is installed [#​5258]

v6.3.0

Compare Source

Updated

• Updated Plotly.js from version 3.0.1 to version 3.1.0. See the Plotly.js release notes for more information. [#​5318]

Added

• Exposed plotly.io.get_chrome() as a function which can be called from within a Python script. [#​5282]

Fixed

• Resolved issue causing extraneous engine deprecation warnings [#​5287], with thanks to @​jdbeel for the contribution!

v6.2.0

Compare Source

Added

• Add SRI (Subresource Integrity) hash support for CDN script tags when using include_plotlyjs='cdn'. This enhances security by ensuring browser verification of CDN-served plotly.js files [#​5165] (with thanks to @​ddworken)

Fixed

• Allow setting Plotly.js path via pio.defaults [#​5207]

Changed

• Refactor validation code to reduce bundle size [#​5214] (with thanks to @​bmaranville)
• Add deprecation warnings when using Kaleido v0 or deprecated image export features [#​5177]

v6.1.2

Compare Source

Fixed

• Fix type checking and code highlighting for graph_objects classes [#​5199]

v6.1.1

Compare Source

Fixed

• Prevent swallowing of ValueError when creating a figure with subplots [#​3888]
• Fix issue causing fig.write_image() to not generate an image [#​5193]

v6.1.0

Compare Source

Updated

• Add support for Kaleido>=v1.0.0 for image generation [#​5062, #​5177]
• Reduce package bundle size by 18-24% via changes to code generation [#​4978]

Fixed

• Fix third-party widget display issues in v6 [#​5102]
• Add handling for case where jupyterlab or notebook is not installed [#​5104]
• Fix issue causing Plotly.js script to be embedded multiple times in Jupyter notebooks [#​5112]
• Re-add MIME renderer JupyterLab extension with JupyterLab 4 support to reduce file sizes for offline notebooks [#​5096]
• Fix issue preventing plots from rendering in HTML notebook export when using 'vscode+notebook' renderer [#​5154]

v6.0.1

Compare Source

Updated

• Updated Plotly.js from version 3.0.0 to version 3.0.1. See the plotly.js CHANGELOG for more information.

Fixed

• Fix TypeError when using orjson to serialize pandas.NA [#​5040].
• Fix issue where using category_orders on px.pie raised ColumnNotFoundError [#​5000].
• Fix incorrect DeprecationWarning shown when creating a px chart [#​5080, #​5086]

v6.0.0

Compare Source

Added

• Add plotly[express] extra for easily installing Plotly Express dependencies [#​4644]
• Add subtitle attribute to all Plotly Express traces [#​4830].

Removed

• Drop deprecated pointcloud and heatmapgl traces from the API [#​4815]
• Drop tenacity dependency [#​4831]
• Drop support for Jupyter Notebook version 6 and earlier [#​4822]. The minimum supported version is now 7.0.0.

Updated

• Update Plotly.js from version 2.34.2 to version 3.0.0 See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Make offsetgroup work with barmode "stacked" and "relative" for bar traces [#​7009]
  • Drop support for deprecated attributes titlefont, titleposition, titleside, and titleoffset [#​7212].
  • Drop deprecated pointcloud and heatmapgl traces and gl2d subplots [#​7213]
  • Drop support for deprecated bardir attribute (use orientation instead) [#​7214]
  • Drop support for deprecated annotation.ref attribute (use annotation.xref and annotation.yref instead) [#​7215]
  • Drop support for deprecated error bar opacity attribute (use alpha channel of error bar color attribute instead) [#​7214]
  • Drop support for deprecated attribute gl3d.cameraposition (use gl3d.camera instead) [#​7217]
  • Drop deprecated plot3dPixelRatio from config [#​7231]
  • Drop deprecated zauto, zmin and zmax from the surface trace [#​7234]
  • Drop deprecated autotick attributes from cartesian axes [#​7236]
  • Drop transforms from the API [#​7240, #​7254]
• Deprecate Mapbox-based traces.[#​4900]. See the MapLibre Migration page for details on migrating from Mapbox to Maplibre.
• Update plotly.py to use base64 encoding of typed arrays e.g. numpy in plotly JSON to keep precision intact and improve performance [#​4470].
• Make plotly-express dataframe agnostic via Narwhals [#​4790].
• Update go.FigureWidget to use anywidget [#​4823]
• Use modern native ES6 import to load plotly.js bundle instead of requirejs which is no longer under active development [#​4736]

Fixed

• Fix a bug in JupyterLab >= 4 and Jupyter Notebook >= 7 that caused LaTeX to not render in plotly charts [#​4763].
• Fix go.FigureWidget.show to return FigureWidget instead of displaying Figure [#​4869]

v5.24.1

Compare Source

Updated

• Updated Plotly.js from version 2.35.0 to version 3.0.0-rc.0. See the plotly.js CHANGELOG for more information.

v5.24.0

Compare Source

Added

• New px functions for maps: scatter_map, line_map, choropleth_map, and density_map.

Updated

• Updated Plotly.js from version 2.34.0 to version 2.35.0. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:

  • Add new traces: scattermap, choroplethmap and densitymap and map subplots which use maplibre to render maps [#​7015, #​7060, #​7085, #​7088, #​7090, #​7092, #​7094, #​7134]
  • Deprecate mapbox traces and mapbox subplot [#​7087]

• Fixed a bug in integer validation of arrays that threw an error when an array contained a mix of strings and integers.

v5.23.0

Compare Source

Updated

• Updated Plotly.js from version 2.32.0 to version 2.34.0. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add subtitle attribute to layout.title to enable adding subtitles to plots [#​7012]
  • Introduce "u" and "s" pseudo html tags to add partial underline and strike-through styles to SVG text elements [#​7043]
  • Add geometric mean functionality and 'geometric mean ascending' + 'geometric mean descending' to category_order on cartesian axes [#​6223],
    with thanks to @​acxz and @​prabhathc for the contribution!
  • Add axis property ticklabelindex for drawing the label for each minor tick n positions away from a major tick,
    with thanks to @​my-tien for the contribution! [#​7036]
  • Add property ticklabelstandoff and ticklabelshift to cartesian axes to adjust positioning of tick labels,
    with thanks to @​my-tien for the contribution! [#​7006]
  • Add x0shift, x1shift, y0shift, y1shift to shapes to add control over positioning of shape vertices on (multi-)category axes,
    with thanks to @​my-tien for the contribution! [#​7005]
• Specify Python version 3.8-3.11 for development virtual environments and pin pytest at version 8.1.1 to match.
• Update IntegerValidator to handle extras option to allow supporting additional keyword values. For example, 'bold' and 'normal' as well as integers as used in font weights [#​4612].

v5.22.0

Compare Source

Updated

• Updated Plotly.js from version 2.31.1 to version 2.32.0. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add "bold" weight, "italic" style and "small-caps" variant options to fonts [#​6956]
  • Fix applying autotickangles on axes with showdividers as well as cases where tickson is set to "boundaries" [#​6967], with thanks to @​my-tien for the contribution!
  • Fix positioning of multi-line axis titles with standoff [#​6970], with thanks to @​my-tien for the contribution!

v5.21.0

Compare Source

Updated

• Updated Plotly.js from version 2.30.0 to version 2.31.1. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add zorder attribute to various cartesian traces for controlling stacking order of SVG traces drawn into a subplot [#​6918, #​6953],
    This feature was anonymously sponsored: thank you to our sponsor!
  • Add "between" option to shape layer for placing them above grid lines and below traces [#​6927],
    with thanks to @​my-tien for the contribution!
  • Add "raw" sizemode to cone trace [#​6938]
  • Add layout.hoversubplots to enable hover effects across multiple cartesian suplots sharing one axis [#​6947, #​6950]

Fixed

• Fixed orjson loading issue [#​4562]

v5.20.0

Compare Source

Updated

• Updated Plotly.js from version 2.29.1 to version 2.30.0. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add fill gradients for scatter traces [#​6905], with thanks to @​lumip for the contribution!
  • Add indentation to legend [#​6874], with thanks to @​my-tien for the contribution!

v5.19.0

Compare Source

Updated

• Updated Plotly.js from version 2.27.0 to version 2.29.1. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add layout.barcornerradius and trace.marker.cornerradius properties to support rounding the corners of bar traces [#​6761],
    with thanks to Displayr for sponsoring development!
  • Add autotickangles to cartesian and radial axes [#​6790], with thanks to @​my-tien for the contribution!
  • Add align option to sankey nodes to control horizontal alignment [#​6800],
    with thanks to @​adamreeve for the contribution!
  • Add the possibility of loading "virtual-webgl" script for WebGL 1 to help display several WebGL contexts on a page [#​6784], with thanks to @​greggman for the contribution!
  • Add options to use base64 encoding (bdata) and shape (for 2 dimensional arrays) to declare various typed arrays i.e. dtype=(float64|float32|int32|int16|int8|uint32|uint16|uint8) [#​5230]
  • Adjust stamen styles to point to stadiamaps.com, the users may also need to provide their own API_KEY via config.mapboxAccessToken [#​6776, #​6778]
• Removed Python 3.6 and Python 3.7 support [#​4492]

Fixed

• Ensure scatter mode is deterministic from px [#​4429]
• Fix issue with creating dendrogram in subplots [#​4411],
• Fix issue with px.line not accepting "spline" line shape [#​2812]
• Fix KeyError when using column of pd.Categorical dtype with unobserved categories [#​4437]
• Fix dataframe interchange in case column_names returns an unmaterialized object: generator, iterator, etc. [#​4442]
• Fix issue with FutureWarning being displayed when setting the color argument in plotly.express [#​4519]

v5.18.0

Compare Source

Updated

• Updated Plotly.js from version 2.26.0 to version 2.27.0. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add insiderange to cartesian axes to help avoid overlap between visible grid lines and tick labels of the counter axis when they are positioned inside [#​6735], this feature was anonymously sponsored: thank you to our sponsor!
  • Fix column order changes on hover [#​6718],
    with thanks to @​bhavinpatel1109 for the contribution!
  • Fix hover at timestamp '1970-01-01 00:00:00' [#​6752],
    with thanks to @​adamjhawley for the contribution!
  • Fix clearing empty candlestick using react [#​6757]

Fixed

• Repair crash on Matplotlib 3.8 related to get_offset_position [#​4372],
• Handle deprecation of pandas.Series.dt.to_pydatetime() calls and suppress the FutureWarning they currently emit. [#​4379]

v5.17.0

Compare Source

Updated

• Improved json docstrings, added BasePlotlyType.to_json() method [#​4301]
• Updated Plotly.js from version 2.25.2 to version 2.26.0. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add "min", "max", "min reversed" and "max reversed" autorange options and handle partial ranges (i.e. one end being null), add autorangeoptions (clipmin, clipmax, minallowed, maxallowed, include) as well as minallowed and maxallowed to cartesian, gl3d and radial axes [#​6547]
  • Add [n]-sigma (std deviations) box plots as an alternative to quartiles [#​6697], with thanks to @​28raining for the contribution!
  • Add "top left" & "top center" side options to legend title [#​6711], with thanks to @​28raining for the contribution!
  • Add "false" option to scaleanchor to allow removing a constraint that is set by default [#​6712], with thanks to @​lvlte for the contribution!

Fixed

• Fixed two issues with px.imshow: [#​4330] when facet_col is an earlier dimension than animation_frame for xarrays and [#​4329] when facet_col has string coordinates in xarrays [#​4331]

v5.16.1

Compare Source

Fixed

• Fixed issue with necessary columns from complex arguments dropped when interchanging dataframes [#​4324]

v5.16.0

Compare Source

Updated

• Updated Plotly.js from version 2.24.1 to version 2.25.2. See the plotly.js CHANGELOG for more information. These changes are reflected in the auto-generated plotly.graph_objects module. Notable changes include:
  • Add "Equal Earth" projection to geo subplots [#​6670],
    with thanks to @​apparebit for the contribution!
  • Add options to include legends for shapes and newshape [#​6653]
• px methods now accept data-frame-like objects that support a dataframe interchange protocol, such as polars, vaex, modin etc. This protocol has priority on to_pandas call, but will only be used if pandas>=2.0.2 is installed in the environment.
• px methods now accept data-frame-like objects that support a toPandas() method, such as Spark DataFrames, or a to_pandas_df() method, such as Vaex DataFrames.

Fixed

• Fixed Pandas performance warning issue caused by multiple frame.insert [#​4246]