plotly / plotly/plotly.py

Plotly 5.x recommends `pip install -U kaleido` which is no longer compatible

Open
#5,241 0 comments 0 reactions 1 assignee View on GitHub

@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

  1. Install plotly 5.x (pip install "plotly<6.0.0")
  2. 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/)
  3. Follow the steps in the error message to install kaleido pip install -U kaleido
  4. 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:

  1. In plotly 5.x, update the error message to say pip install -U "kaleido<1.0.0": https://github.com/plotly/plotly.py/blob/5d79b80c53f779274170743539a481c524e04c8f/packages/python/plotly/plotly/io/_kaleido.py#L136
  2. In kaleido 1.x, update the error message to say how to upgrade plotly or downgrade kaleido, e.g. pip install -U plotly, or pip install "kaleido<1.0.0"

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.