{"id":23418,"library":"chart-studio","title":"plotly chart-studio","description":"Utilities for interfacing with plotly's Chart Studio service. Deprecated alternative to the Plotly Express / plotly.graph_objects + plotly.io approach. Version 1.1.0 is the final release; package is in maintenance mode.","status":"deprecated","version":"1.1.0","language":"python","source_language":"en","source_url":"https://github.com/plotly/chart-studio","tags":["plotly","chart-studio","visualization","deprecated"],"install":[{"cmd":"pip install chart-studio","lang":"bash","label":"install"}],"dependencies":[],"imports":[{"note":"chart_studio.plotly is the legacy Chart Studio interface; prefer plain plotly for offline charts.","wrong":"import chart_studio.plotly as py","symbol":"plotly","correct":"import plotly"},{"note":"plotly.plotly was removed after plotly v2. Use chart_studio.plotly for legacy chart_studio users.","wrong":"import plotly.plotly as py","symbol":"plotly_plotly","correct":"from chart_studio import plotly as py"},{"note":"Credentials are now managed via chart_studio.","wrong":"plotly.tools.set_credentials_file()","symbol":"plotly_credentials","correct":"from chart_studio import plotly as py\npy.sign_in(username, api_key)"}],"quickstart":{"code":"import chart_studio\nimport chart_studio.plotly as py\nimport plotly.graph_objects as go\n\nchart_studio.tools.set_credentials_file(username='your_username', api_key='your_api_key')\n\nfig = go.Figure(data=go.Bar(y=[2, 3, 1]))\npy.plot(fig, filename='basic-bar', auto_open=True)","lang":"python","description":"Basic example: set credentials and upload a figure to Chart Studio."},"warnings":[{"fix":"Use `pip install plotly` and `plotly.io.write_html()` or `plotly.io.to_html()` for offline usage. For Chart Studio uploads, consider the new Plotly Chart Studio API: https://plotly.com/python/chart-studio/","message":"chart-studio is in maintenance mode. The primary plotly package now includes Chart Studio upload via plotly.io.write_html() or using Plotly Express with the `url` parameter. Avoid new projects depending on chart-studio.","severity":"deprecated","affected_versions":"all"},{"fix":"Set valid credentials via chart_studio.tools.set_credentials_file() before calling any upload function.","message":"chart_studio.plotly.sign_in() requires a valid Chart Studio account and API key. Using invalid credentials leads to HTTP 401 errors.","severity":"breaking","affected_versions":"all"},{"fix":"Use explicit module references: `import chart_studio.plotly as py` and then `py.plot(fig)` vs `plotly.io.show(fig)`.","message":"Importing from chart_studio.plotly overrides the top-level plotly module's plot function. This can break code that expects the offline plotly.plot() behavior.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Replace `import plotly.plotly as py` with `from chart_studio import plotly as py`.","cause":"Migrating from old plotly (pre-v3) to newer versions: 'plotly.plotly' was removed. Use chart_studio.plotly for Chart Studio functionality.","error":"AttributeError: module 'plotly' has no attribute 'plotly'"},{"fix":"Run `pip install chart-studio` to install the package.","cause":"chart_studio package not installed or version mismatch.","error":"ImportError: cannot import name 'plotly' from 'chart_studio' (unknown location)"},{"fix":"Set credentials: `chart_studio.tools.set_credentials_file(username='your_username', api_key='your_api_key')`. Obtain API key from https://plotly.com/settings/api.","cause":"Credentials are missing, invalid, or expired.","error":"HTTPError: 401 Client Error: Unauthorized for url: https://api.plot.ly/v2/..."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}