{"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,"search_vec":"'1.1.0':25 'altern':15 'approach':23 'chart':3,11,37 'chart-studio':2,36 'deprec':14,40 'express':19 'final':28 'interfac':7 'mainten':33 'mode':34 'object':21 'packag':30 'plot':1,9,18,35 'plotly.graph':20 'plotly.io':22 'releas':29 'servic':13 'studio':4,12,38 'util':5 'version':24 'visual':39","created_at":"2026-05-01T08:07:40.569995+00:00","updated_at":"2026-05-01T08:07:40.569995+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.1.0","cli_name":"","cli_version":null,"type":"library","homepage":"https://plot.ly/python/","github":"https://github.com/plotly/plotly.py","docs":null,"changelog":null,"pypi":"https://pypi.org/project/chart-studio/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","http-networking"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}