Skip to content

Commit 2e2d1f0

Browse files
authored
Merge pull request #5692 from tomatotomata/codex/document-jupyter-renderer-fallback
docs: explain Jupyter blank-render workaround
2 parents 304fb76 + 6086def commit 2e2d1f0

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

doc/python/troubleshooting.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,3 +78,15 @@ The situation is similar for environments like Nteract and Streamlit: in these e
7878
### Orca Problems
7979

8080
> The Orca image-generation utility is no longer supported in Plotly.py as of version 7.0.0. See the [Static Image Export page](/python/static-image-export/) for details on using Kaleido for static image generation.
81+
82+
### Jupyter and JupyterLab Problems
83+
84+
If a figure appears blank in JupyterLab, first check that the Jupyter server environment and the environment used by the notebook kernel can both access the Plotly packages they need. This is especially important when JupyterLab and `plotly` are installed in separate virtual environments.
85+
86+
As a workaround, try the `notebook` renderer explicitly:
87+
88+
~~~python
89+
fig.show(renderer="notebook")
90+
~~~
91+
92+
This can help when the default renderer does not display the figure correctly.

0 commit comments

Comments
 (0)