{"id":2914,"library":"dash-table","title":"Dash DataTable","description":"Dash DataTable (`dash.dash_table.DataTable`) is an interactive table component designed for viewing, editing, and exploring large datasets within Dash web applications. It is rendered with standard HTML <table> markup, making it accessible, responsive, and highly customizable. The `dash-table` PyPI package is currently at version 5.0.0, but the component is officially deprecated and slated for removal from the core Dash API in Dash 5.0 of the main `dash` package. Users are advised to migrate to `dash-ag-grid` for future development.","status":"deprecated","version":"5.0.0","language":"en","source_language":"en","source_url":"https://github.com/plotly/dash","tags":["dash","web app","table","data visualization","interactive","deprecated"],"install":[{"cmd":"pip install dash-table","lang":"bash","label":"Install for backward compatibility (deprecated)"},{"cmd":"pip install dash-ag-grid","lang":"bash","label":"Recommended alternative"}],"dependencies":[{"reason":"Core framework for building Dash applications.","package":"dash","optional":false},{"reason":"Commonly used for data manipulation and preparing data for the table.","package":"pandas","optional":true}],"imports":[{"note":"As of Dash 2, `dash_table` is included as part of the main `dash` package. The standalone import `import dash_table` is largely for backward compatibility and may not be supported in future Dash versions.","wrong":"import dash_table","symbol":"DataTable","correct":"from dash import dash_table"}],"quickstart":{"code":"import dash\nfrom dash import dash_table, html\nimport pandas as pd\n\n# Sample data (e.g., from a CSV)\ndf = pd.read_csv('https://raw.githubusercontent.com/plotly/datasets/master/solar.csv')\n\napp = dash.Dash(__name__)\n\napp.layout = html.Div([\n    dash_table.DataTable(\n        id='table-basic',\n        columns=[{\"name\": i, \"id\": i} for i in df.columns],\n        data=df.to_dict('records'),\n    )\n])\n\nif __name__ == '__main__':\n    app.run_server(debug=True)","lang":"python","description":"This quickstart demonstrates how to create a basic Dash application with a DataTable. It reads data from a CSV using pandas and displays it in an interactive table."},"warnings":[{"fix":"Migrate your table implementations to `dash-ag-grid`. Install with `pip install dash-ag-grid` and refer to its documentation.","message":"Dash DataTable is officially deprecated and will be removed from the core Dash API in Dash 5.0. It is strongly recommended to migrate to `dash-ag-grid` for new and existing projects.","severity":"breaking","affected_versions":"All versions, specifically from Dash 5.0 onwards for the main Dash package"},{"fix":"Consult the `dash-table` CHANGELOG or documentation for v4.0.0 migration guides to update property names and usage.","message":"Significant API changes occurred in `dash-table` v4.0.0. Several properties were removed or renamed, such as `column.clearable`, `column.hidden`, `content_style` (replaced by `fill_width`), and `pagination_settings` (replaced by `page_current` and `page_size`).","severity":"breaking","affected_versions":"4.0.0 and later"},{"fix":"Check for known fixes or workarounds in the Plotly community forums or GitHub issues. If possible, upgrade to the latest stable versions of Dash and `dash-table` (or migrate to `dash-ag-grid`). Consider simplifying tooltip logic if the bug persists.","message":"When using pagination with tooltips, the DataTable may become unresponsive and generate errors upon hovering over cells.","severity":"gotcha","affected_versions":"Specific versions, reported in `dash` 1.21.0, `dash-table` 4.11.x, but may affect others."},{"fix":"Always ensure the return value of a multi-output callback matches the expected tuple or list of values for the specified outputs.","message":"For callbacks interacting with the DataTable, ensuring correct return types for multiple outputs is crucial. For instance, a callback with two outputs must return a tuple (data, columns) not a single Div component.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-11T00:00:00.000Z","next_check":"2026-07-10T00:00:00.000Z"}