Plotly 5.x recommends `pip install -U kaleido` which is no longer compatible
Open
@emilykl is already working on this.
Since Jun 25, 2025.
feature
P1
- Dominant language
- Python
- Stars
- 18.8k
- Forks
- 2.8k
- Avg merge
- 16h 26m
- Merged PRs (30d)
- 21
Description
Just ran into this issue since kaleido 1.0.0 was just released yesterday.
Steps to Reproduce
- Install plotly 5.x (
pip install "plotly<6.0.0") - In a python session, create a plotly figure and try to write it using
to_image(using instructions from https://plotly.com/python/static-image-export/) - Follow the steps in the error message to install kaleido
pip install -U kaleido - Repeat step 2
Expected Results
4. Image export should work
Actual Results
4. Get an error about the version of kaleido not being compatible with plotly.
Warning: You have Plotly version 5.24.1, which is not compatible with this version of Kaleido (1.0.0).
This means that static image generation (e.g. `fig.write_image()`) will not work.
Please upgrade Plotly to version 6.1.1 or greater, or downgrade Kaleido to version 0.2.1.
Two things could help here:
- In
plotly 5.x, update the error message to saypip install -U "kaleido<1.0.0": https://github.com/plotly/plotly.py/blob/5d79b80c53f779274170743539a481c524e04c8f/packages/python/plotly/plotly/io/_kaleido.py#L136 - In
kaleido 1.x, update the error message to say how to upgrade plotly or downgrade kaleido, e.g.pip install -U plotly, orpip install "kaleido<1.0.0"
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.