extension:.md

format_name:markdown

format_version:'1.1'

jupytext_version:1.1.6

jupytext_version:1.1.1

kernelspec:

display_name:Python 3

language:python

page_type:example_index

permalink:python/creating-and-updating-figures/

redirect_from:

-python/user-guide/

-python/user-g/

-python/user-guide/

-python/user-g/

thumbnail:thumbnail/creating-and-updating-figures.png

fig.show()

`update_layout` and`update_traces` have an`overwrite` keyword argument, defaulting to False, in which case updates are applied recursively to the*existing* nested property structure. When set to True, the prior value of existing properties is overwritten with the provided value.

In the example below, the red color of markers is overwritten when updating`marker` in`update_traces` with`overwrite=True`. Note that setting instead`marker_opacity` with the magic underscore would not overwrite`marker_color` because properties would be overwritten starting only at the level of`marker.opacity`.

import plotly.graph_objectsas go

fig= go.Figure(go.Bar(x=[1,2,3],y=[6,4,9],

marker_color="red"))# will be overwritten below

fig.update_traces(

overwrite=True,

marker={"opacity":0.4}

)

fig.show()

Suppose the updates that you want to make to a collection of traces depend on the current values of certain trace properties. The`update_traces` method cannot handle this situation, but the`for_each_trace` method can.