Live Chat

We'll need to share your messages (and your email address if you're logged in) with our live chat provider, Drift. Here's their privacy policy.

If you don't want to do this, you can email us instead at

plotly.graph_objs.layout.annotation Module


plotly.graph_objs.layout.annotation.Font([family=], [size=], [color=]) → Font

Create a new ‘Font’ object

  • family - HTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system. The Chart Studio Cloud (at or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include *Arial*, *Balto*, *Courier New*, *Droid Sans*,, *Droid Serif*, *Droid Sans Mono*, *Gravitas One*, *Old Standard TT*, *Open Sans*, *Overpass*, *PT Sans Narrow*, *Raleway*, *Times New Roman*.

plotly.graph_objs.layout.annotation.Hoverlabel([bgcolor=], [bordercolor=], [font=]) → Hoverlabel

Create a new ‘Hoverlabel’ object

  • bgcolor - Sets the background color of the hover label. By default uses the annotation's `bgcolor` made opaque, or white if it was transparent.

  • bordercolor - Sets the border color of the hover label. By default uses either dark grey or white, for maximum contrast with `hoverlabel.bgcolor`.

  • font - Sets the hover label text font. By default uses the global hover font and size, with color from `hoverlabel.bordercolor`.