download opts

Author: nicolaskruchten

doc/python/configuration-options.md

@@ -163,12 +163,14 @@ fig.add_trace(
 fig.show(config=config)
 ```
 
-##### Customizing Download Plot Options
+##### Customizing Download Plot Button Options
 
-```python
-import plotly.graph_objects as go
+The camera icon on the modebar causes a static version of the figure to be downloaded via the user's browser. The default behaviour is to download a PNG of size 700 by 450 pixels.
 
-fig = go.Figure()
+This behavior can be controlled via the `toImageButtonOptions` configuration key.
+
+```python
+import plotly.express as px
 
 config = {
   'toImageButtonOptions': {
@@ -180,10 +182,22 @@ config = {
   }
 }
 
-fig.add_trace(
-    go.Scatter(
-        x=[1, 2, 3],
-        y=[1, 3, 1]))
+fig = px.bar(x=[1, 2, 3], y=[1, 3, 1]))
+
+fig.show(config=config)
+```
+
+Figures can be set to download at the currently-rendered size by setting `height` and `width` to `None`:
+
+
+```python
+import plotly.express as px
+
+config = {
+  'toImageButtonOptions': { 'height': None, 'width': None, }
+}
+
+fig = px.bar(x=[1, 2, 3], y=[1, 3, 1]))
 
 fig.show(config=config)
 ```
@@ -285,4 +299,4 @@ The same configuration dictionary that you pass to the `config` parameter of the
 
 #### Reference
 
-See config options at https://github.com/plotly/plotly.js/blob/master/src/plot_api/plot_config.js#L6
+See config options at https://github.com/plotly/plotly.js/blob/master/src/plot_api/plot_config.js#L6