| Download Studio | https://plotly.com/studio?utm_source=graphing_libraries&utm_medium=documentation&utm_campaign=studio_cloud_community&utm_content=header |
| Studio and Cloud Pricing | https://plotly.com/pricing?utm_source=graphing_libraries&utm_medium=documentation&utm_content=header |
| Dash Enterprise Pricing | https://plotly.com/get-pricing?utm_source=graphing_libraries&utm_medium=documentation&utm_content=header |
| https://plot.ly/python/ |
| https://plot.ly/python/ |
|
Python (v6.5.0)
| https://plotly.com/python/ |
|
R
| https://plotly.com/r/ |
|
Julia
| https://plotly.com/julia/ |
|
Javascript (v3.3.0)
| https://plotly.com/javascript/ |
|
ggplot2
| https://plotly.com/ggplot2/ |
|
MATLAB
| https://plotly.com/matlab/ |
|
F#
| https://plotly.com/fsharp/ |
| Download Studio | https://plotly.com/studio?utm_source=graphing_libraries&utm_medium=documentation&utm_campaign=studio_cloud_community&utm_content=header |
| Studio and Cloud Pricing | https://plotly.com/pricing?utm_source=graphing_libraries&utm_medium=documentation&utm_content=header |
| Dash Enterprise Pricing | https://plotly.com/get-pricing?utm_source=graphing_libraries&utm_medium=documentation&utm_content=header |
| https://plot.ly/python/ |
| Getting Started | https://plot.ly/python/getting-started |
| Is Plotly Free? | https://plot.ly/python/is-plotly-free |
| Figure Reference | https://plot.ly/python/reference/index/ |
| API Reference | https://plot.ly/python-api-reference |
| Dash | https://dash.plotly.com/tutorial |
| GitHub | https://github.com/plotly/plotly.py |
| community.plotly.com | http://community.plotly.com/ |
|
| https://plotly.com/webinars/new-plotly-studio-ai-bi-analytics/?utm_source=graphing_libraries&utm_medium=documentation&utm_campaign=new-plotly-studio-jan-2026&utm_content=sidebar |
|
Python
| https://plot.ly/python |
| Fundamentals | https://plot.ly/python/plotly-fundamentals |
|
Suggest an edit to this page
| https://github.com/plotly/plotly.py/edit/doc-prod/doc/python/figure-structure.md |
| Try Plotly Studio now. | https://plotly.com/studio?utm_source=graphing_libraries&utm_medium=documentation&utm_campaign=studio_cloud_community&utm_content=sidebar |
| ¶ | https://plot.ly/python/figure-structure#Overview |
| create, manipulate | https://plot.ly/python/creating-and-updating-figures/ |
| render | https://plot.ly/python/renderers/ |
| Plotly.js JavaScript library | https://plotly.com/javascript/ |
| JavaScript Object Notation (JSON) | https://json.org/ |
| high-level plotly.express module, also known as Plotly Express | https://plot.ly/python/plotly-express/ |
| other plotly.graph_objects components | https://plot.ly/python/graph-objects/ |
| ¶ | https://plot.ly/python/figure-structure#Accessing-figure-structures-in-Dash |
| Dash | https://plotly.com/dash/ |
| the official Dash docs | https://dash.plotly.com/installation |
| style | https://plotly.com/dash/design-kit/ |
| Dash Enterprise | https://plotly.com/dash/ |
| Plotly Cloud | https://plotly.com/cloud/ |
| Join now | https://go.plotly.com/dash-club?utm_source=Dash+Club+2022&utm_medium=graphing_libraries&utm_content=inline |
| ¶ | https://plot.ly/python/figure-structure#Figures-as-Trees-of-Attributes |
| Figure Reference | https://plot.ly/python/reference/index/ |
| machine-readable JSON representation of the schema | https://raw.githubusercontent.com/plotly/plotly.js/master/dist/plot-schema.json |
| Figure Reference | https://plot.ly/python/reference/index/ |
| Figure Reference | https://plot.ly/python/reference/index/ |
| plotly.graph_objects module contains an automatically-generated hierarchy of Python classes | https://plot.ly/python/graph-objects/ |
| manipulating a plotly.graph_objects.Figure object | https://plot.ly/python/creating-and-updating-figures/ |
| update methods and "magic underscores" | https://plot.ly/python/creating-and-updating-figures/#magic-underscore-notation |
| the JavaScript layer will compute default values | https://plot.ly/python/figure-introspection/ |
| Figure Reference | https://plot.ly/python/reference/index/ |
| the layout.template key is present (as it is by default) | https://plot.ly/python/templates/ |
| ¶ | https://plot.ly/python/figure-structure#The-Top-Level-data-Attribute |
| scatter | https://plot.ly/python/line-and-scatter/ |
| bar | https://plot.ly/python/bar-charts/ |
| pie | https://plot.ly/python/pie-charts/ |
| surface | https://plot.ly/python/3d-surface-plots/ |
| choropleth | https://plot.ly/python/choropleth-maps/ |
| subplot | https://plot.ly/python/subplots/ |
| legend | https://plot.ly/python/legend/ |
| continuous color, with an associated colorbar | https://plot.ly/python/colorscales/ |
| coloraxis attribute | https://plot.ly/python/colorscales/ |
| ¶ | https://plot.ly/python/figure-structure#The-Top-Level-layout-Attribute |
| templates | https://plot.ly/python/templates/ |
| fonts | https://plot.ly/python/figure-labels/ |
| Title | https://plot.ly/python/figure-labels/ |
| legend | https://plot.ly/python/legend/ |
| Color axes and associated color bars | https://plot.ly/python/colorscales/ |
| textual annotations with or without arrows | https://plot.ly/python/text-and-annotations/ |
| lines, rectangles, ellipses or open or closed paths | https://plot.ly/python/shapes/ |
| background or decorative images | https://plot.ly/python/images/ |
| single buttons, toggles | https://plot.ly/python/custom-buttons/ |
| dropdown menus | https://plot.ly/python/dropdowns/ |
| slider controls | https://plot.ly/python/sliders/ |
| ¶ | https://plot.ly/python/figure-structure#The-Top-Level-frames-Attribute |
| animated plot | https://plot.ly/python/animations/ |
| ¶ | https://plot.ly/python/figure-structure#The-config-Object |
| render-time | https://plot.ly/python/renderers/ |
| config, and has its own documentation page | https://plot.ly/python/configuration-options/ |
| ¶ | https://plot.ly/python/figure-structure#Positioning-With-Paper,-Container-Coordinates,-or-Axis-Domain-Coordinates |
| ¶ | https://plot.ly/python/figure-structure#2D-Cartesian-Trace-Types-and-Subplots |
| two-dimensional Cartesian subplot | https://plot.ly/python/axes/ |
| continuous values (type="linear", type="log") | https://plot.ly/python/axes/ |
| temporal values (type="date") | https://plot.ly/python/time-series/ |
| categorical values (type="category", type="multicategory) | https://plot.ly/python/bar-charts/ |
| dual-axis or multiple-axis charts | https://plot.ly/python/multiple-axes/ |
| "small multiples" figures, also known as facet or trellis plots | https://plot.ly/python/facet-plots/ |
| scatter | https://plot.ly/python/line-and-scatter/ |
| scattergl | https://plot.ly/python/webgl-vs-svg/ |
| scatter plots | https://plot.ly/python/line-and-scatter/ |
| line plots and curves | https://plot.ly/python/line-charts/ |
| time-series plots | https://plot.ly/python/time-series/ |
| bubble charts | https://plot.ly/python/bubble-charts/ |
| dot plots | https://plot.ly/python/dot-plots/ |
| filled areas | https://plot.ly/python/filled-area-plots/ |
| error bars | https://plot.ly/python/error-bars/ |
| bar | https://plot.ly/python/bar-charts/ |
| funnel | https://plot.ly/python/funnel-charts/ |
| waterfall | https://plot.ly/python/waterfall-charts/ |
| timelines and Gantt charts | https://plot.ly/python/gantt/ |
| histogram | https://plot.ly/python/histograms/ |
| box | https://plot.ly/python/box-plots/ |
| violin | https://plot.ly/python/box-plots/ |
| histogram2d | https://plot.ly/python/2D-Histogram/ |
| histogram2dcontour | https://plot.ly/python/2d-histogram-contour/ |
| image | https://plot.ly/python/imshow/ |
| heatmap | https://plot.ly/python/heatmaps/ |
| contour | https://plot.ly/python/contour-plots/ |
| ohlc | https://plot.ly/python/ohlc-charts/ |
| candlestick | https://plot.ly/python/candlestick-charts/ |
| carpet | https://plot.ly/python/carpet-plot/ |
| carpet plots | https://plot.ly/python/carpet-plot/ |
| splom | https://plot.ly/python/splom/ |
| ¶ | https://plot.ly/python/figure-structure#3D,-Polar,-Ternary-and-Smith-Trace-Types-and-Subplots |
| three-dimensional cartesian subplots | https://plot.ly/python/3d-charts/ |
| polar subplots | https://plot.ly/python/polar-chart/ |
| ternary subplots | https://plot.ly/python/ternary-plots/ |
| smith subplots | https://plot.ly/python/smith-charts/ |
| camera controls | https://plot.ly/python/3d-camera-controls/ |
| scatter3d | https://plot.ly/python/3d-scatter-plots/ |
| individual markers | https://plot.ly/python/3d-scatter-plots/ |
| 3d bubble charts | https://plot.ly/python/3d-bubble-charts/ |
| lines and curves | https://plot.ly/python/3d-line-plots/ |
| surface | https://plot.ly/python/3d-surface-plots/ |
| mesh | https://plot.ly/python/3d-mesh/ |
| cone | https://plot.ly/python/cone-plot/ |
| streamtube | https://plot.ly/python/streamtube-plot/ |
| volume | https://plot.ly/python/3d-volume-plots/ |
| isosurface | https://plot.ly/python/3d-isosurface-plots/ |
| scatterpolar and scatterpolargl | https://plot.ly/python/polar-chart/ |
| curves and filled areas (i.e. radar or spider charts) | https://plot.ly/python/radar-chart/ |
| barpolar | https://plot.ly/python/wind-rose-charts/ |
| wind roses | https://plot.ly/python/wind-rose-charts/ |
| scatterternary | https://plot.ly/python/ternary-plots/ |
| curves and filled areas | https://plot.ly/python/ternary-contour/ |
| scattersmith | https://plot.ly/python/smith-charts/ |
| ¶ | https://plot.ly/python/figure-structure#Map-Trace-Types-and-Subplots |
| geo subplots for outline maps | https://plot.ly/python/map-configuration/ |
| tile-based maps | https://plot.ly/python/tile-map-layers/ |
| scattergeo | https://plot.ly/python/scatter-plots-on-maps/ |
| individual markers | https://plot.ly/python/scatter-plots-on-maps/ |
| line and curves | https://plot.ly/python/lines-on-maps/ |
| choropleth | https://plot.ly/python/choropleth-maps/ |
| colored polygons | https://plot.ly/python/choropleth-maps/ |
| scattermap | https://plot.ly/python/tile-scatter-maps/ |
| individual markers | https://plot.ly/python/tile-scatter-maps/ |
| lines and curves | https://plot.ly/python/lines-on-tile-maps/ |
| filled areas | https://plot.ly/python/filled-area-tile-maps/ |
| choroplethmap | https://plot.ly/python/tile-county-choropleth/ |
| densitymap | https://plot.ly/python/tile-density-heatmaps/ |
| ¶ | https://plot.ly/python/figure-structure#Traces-Which-Are-Their-Own-Subplots |
| pie | https://plot.ly/python/pie-charts/ |
| funnelarea | https://plot.ly/python/waterfall-charts/ |
| sunburst | https://plot.ly/python/sunburst-charts/ |
| treemap | https://plot.ly/python/treemaps/ |
| parcoords | https://plot.ly/python/parallel-coordinates-plot/ |
| parcats | https://plot.ly/python/parallel-categories-diagram/ |
| parallel coordinates | https://plot.ly/python/parallel-coordinates-plot/ |
| parallel sets | https://plot.ly/python/parallel-categories-diagram/ |
| sankey | https://plot.ly/python/sankey-diagram/ |
| flow diagrams | https://plot.ly/python/sankey-diagram/ |
| table | https://plot.ly/python/table/ |
| text-based tables | https://plot.ly/python/table/ |
| indicator | https://plot.ly/python/indicator/ |
| gauges | https://plot.ly/python/gauge-charts/ |
| bullet charts | https://plot.ly/python/bullet-charts/ |
| ¶ | https://plot.ly/python/figure-structure#Carpet-Trace-Types-and-Subplots |
| traces of type carpet as a subplot | https://plot.ly/python/carpet-plot/ |
| scattercarpet | https://plot.ly/python/carpet-scatter/ |
| contourcarpet | https://plot.ly/python/carpet-plot/ |
| ¶ | https://plot.ly/python/figure-structure#Trace-Types,-Legends-and-Color-Bars |
| legend | https://plot.ly/python/legend/ |
| discrete color | https://plot.ly/python/discrete-color/ |
| Plotly Express has robust support for discrete color | https://plot.ly/python/discrete-color/ |
| continuous color | https://plot.ly/python/colorscales/ |
| ¶ | https://plot.ly/python/figure-structure#What-About-Dash? |
| Dash | https://dash.plot.ly/ |
| https://dash.plot.ly/installation | https://dash.plot.ly/installation |
| Graph component | https://dash.plot.ly/dash-core-components/graph |
| https://plotly.com/studio?utm_source=graphing_libraries&utm_medium=documentation&utm_content=python_footer |
|
Subscribe
| https://plotly.com/newsletter/?utm_source=graphing_libraries&utm_medium=documentation&utm_content=footer |
| Plotly Studio | https://plotly.com/studio?utm_source=graphing_libraries&utm_medium=documentation&utm_campaign=studio_cloud_community&utm_content=footer |
| Plotly Cloud | https://plotly.com/cloud?utm_source=graphing_libraries&utm_medium=documentation&utm_campaign=studio_cloud_community&utm_content=footer |
| Dash Enterprise | https://plotly.com/dash/?utm_source=graphing_libraries&utm_medium=documentation&utm_content=footer |
| New Releases → | https://plotly.com/whats-new/?utm_source=graphing_libraries&utm_medium=documentation&utm_content=footer |
| Studio and Cloud Pricing | https://plotly.com/pricing?utm_source=graphing_libraries&utm_medium=documentation&utm_content=footer |
| Dash Enterprise Pricing | https://plotly.com/get-pricing?utm_source=graphing_libraries&utm_medium=documentation&utm_content=footer |
| Careers | https://plotly.com/careers?utm_source=graphing_libraries&utm_medium=documentation&utm_content=footer |
| Resources | https://plotly.com/resources/?utm_source=graphing_libraries&utm_medium=documentation&utm_content=footer |
| Blog | https://plotly.com/blog/?utm_source=graphing_libraries&utm_medium=documentation&utm_content=footer |
| Community Support | https://community.plot.ly/ |
| Documentation | https://plotly.com/graphing-libraries |
| Terms of Service | https://community.plotly.com/tos |
| Privacy Policy | https://plotly.com/privacy/ |