plotly

library6.6.0pypypiunverified

Plotly is an interactive, open-source data visualization library for Python, built on top of the Plotly JavaScript library (plotly.js). It supports over 40 unique chart types, enabling users to create rich, interactive web-based visualizations that can be displayed in Jupyter notebooks, saved as standalone HTML files, or integrated into pure Python web applications using Dash. Currently at version 6.6.0, Plotly maintains an active development and release cadence.

data web-framework

pip install plotly

github ↗package ↗homepage ↗docs ↗changelog ↗

Install & Compatibility

Where this runs

tested against v6.8.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

8/10 runs

py 3.11

8/10 runs

py 3.12

8/10 runs

py 3.13

8/10 runs

py 3.9

8/10 runs

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

express

✓ import plotly.express as px

✗ import plotly.express as px

This quickstart demonstrates creating a basic bar chart using `plotly.express`, the high-level API. The `fig.show()` method renders the interactive plot, typically in a browser or Jupyter environment.

import plotly.express as px # Create a simple bar chart fig = px.bar(x=["A", "B", "C"], y=[1, 3, 2], title="My First Plotly Chart") # Display the figure (opens in browser/notebook) fig.show()

Debug

Known issues

breakingPlotly.py 6.0 dropped support for Jupyter Notebook versions prior to 7.0. Users on older Jupyter versions will need to upgrade.

fix

Upgrade your Jupyter Notebook installation to version 7.0 or newer (e.g., `pip install --upgrade notebook`).

affects: 6.0.0 and later

breakingPlotly.py 6.0 introduced a rewrite of dataframe performance using the Narwhals abstraction layer instead of solely relying on the Pandas API. While generally providing performance gains, this might subtly affect direct Pandas dataframe interactions for users upgrading from older versions.

fix

Review code interacting directly with Pandas DataFrames if experiencing unexpected behavior or performance changes after upgrading. Consider adopting the dataframe interchange protocol for broader compatibility.

affects: 6.0.0 and later

breakingPlotly.js 3.0 (which plotly.py 6.0 is built upon) removed support for several deprecated attributes (e.g., `titlefont`, `titleposition`, `titleside`, `titleoffset`) and specific trace types like `pointcloud` and `heatmapgl`.

fix

Consult the Plotly.js 3.0 changelog for replacement attributes or alternative trace types if using any of the removed features.

affects: 6.0.0 and later

gotchaFor static image export of Plotly figures (e.g., to PNG, JPEG, SVG, PDF), the `kaleido` package is the recommended engine since Plotly 4.9. The older `orca` command-line utility is now considered legacy and may have compatibility issues.

fix

Install `kaleido` (`pip install -U kaleido`) for reliable static image export. Remove any reliance on `orca`.

affects: 4.9.0 and later

gotchaWhen creating figures, `plotly.express` automatically infers sensible defaults and is much more concise (5-100 times less code) than building figures directly with `plotly.graph_objects`. Using `go` requires explicit definition of traces and layout.

fix

For most common plotting needs, start with `plotly.express`. Use `plotly.graph_objects` when `plotly.express` doesn't provide the necessary customization or for highly specialized plots (e.g., certain 3D trace types, complex subplots with different types).

affects: All versions

Upgrade

Version history

6.8.0latest on PyPI

Audit

Dependencies

kaleidooptionalRecommended for static image export (PNG, JPEG, SVG, PDF) of figures.

plotly-geooptionalProvides extended geographic shape files for certain choropleth maps and other geo-specific features.

pandasoptionalCommonly used for data preparation and input with Plotly Express functions.

Agent activity

20 hits · last 30 days

node

seranking-bot

ahrefsbot