scatter attributes

Markers, lines (linear, spline, steps), text labels, filled and stacked areas and bubbles at x/y positions, with error bars and colorscales; every part is one GPU draw call regardless of the point count.

• Categories: cartesian, symbols, showLegend, errorBarsOK
• Plotly equivalent: scatter / scattergl
• Guide: scatter chart page
• Used in examples: accessibility/data-table, accessibility/description, accessibility/keyboard-focus, accessibility/safe-palette, accessibility/summary, area/band, area/basic, area/depth-stacked, area/depth-toself, area/depth, area/gradient, area/pattern, area/percent, area/stacked-horizontal, area/stacked, area/stackgaps, area/streamgraph, area/toself, axes/demand-temperature, axes/hr-diagram, axes/linked-axes, axes/revenue-margin, axes/scaleanchor, axes/spike-lines, bar/period, bubble/basic, bubble/colorscale, bubble/labels, bubble/sizemode, bubble/sizeref, colorbars/scatter-exponent-colorbar, contour/uneven-grid, controls/buttons, controls/dropdowns, controls/plotly-look, controls/slider, demos/dallas-weather/animated-months, demos/dallas-weather/annual-mean, demos/dallas-weather/climograph, demos/dallas-weather/daily-record, demos/dallas-weather/events, demos/dallas-weather/freeze-dates, demos/dallas-weather/hottest-coldest, demos/dallas-weather/rain-cumulative, demos/dallas-weather/seasons-shift, demos/dallas-weather/summer-bubbles, demos/dallas-weather/year-in-days, demos/index-funds/asset-growth, demos/index-funds/best-worst-days, demos/index-funds/candles, demos/index-funds/density, demos/index-funds/drawdown-episodes, demos/index-funds/drawdowns, demos/index-funds/growth, demos/index-funds/halves-dumbbell, demos/index-funds/halves-rebased, demos/index-funds/megacaps, demos/index-funds/relative-strength, demos/index-funds/risk-return, demos/index-funds/rolling-corr, demos/index-funds/rolling-vol, demos/index-funds/sector-ranks, demos/index-funds/sixty-forty, demos/index-funds/vix, demos/index-funds/yields, demos/openrouter/authors-area, demos/openrouter/industry, demos/openrouter/models-bubble, demos/openrouter/requests-by-author, demos/openrouter/tokens-per-request, demos/openrouter/weekly-tokens, demos/repo-graphs/directory-match, demos/science-basics/decay-area, demos/science-basics/dipole-contour, demos/science-basics/discovery, demos/science-basics/electron-cloud, demos/science-basics/element-bubbles, demos/science-basics/gas-speeds, demos/science-basics/heating-curve, demos/science-basics/hooke, demos/science-basics/interference, demos/science-basics/kepler, demos/science-basics/motion-graphs, demos/science-basics/ohm, demos/science-basics/pendulum-box, demos/science-basics/pendulum-energy, demos/science-basics/periodic-trends, demos/science-basics/phase-diagram, demos/science-basics/projectile, demos/science-basics/superposition, demos/science-basics/titration, demos/thc-gummies/abstinence, demos/thc-gummies/bioavailability, demos/thc-gummies/blood-peaks, demos/thc-gummies/detection-windows, demos/thc-gummies/effect-by-dose, demos/thc-gummies/effect-windows, demos/thc-gummies/gummies, demos/thc-gummies/half-lives, demos/thc-gummies/metabolite, demos/thc-gummies/smoked-peaks, demos/tirzepatide/class-weight-loss, demos/tirzepatide/outcomes-forest, demos/tirzepatide/programme, demos/tirzepatide/receptor-potency, demos/tirzepatide/surmount5, demos/tirzepatide/surpass-cvot, demos/tirzepatide/withdrawal, demos/tqqq-soxl/candles, demos/tqqq-soxl/daily-leverage, demos/tqqq-soxl/decay-contour, demos/tqqq-soxl/drawdowns, demos/tqqq-soxl/growth, demos/tqqq-soxl/intraday, demos/tqqq-soxl/returns-histogram, demos/tqqq-soxl/risk-return, demos/tqqq-soxl/rolling-vol, export/to-image, gantt/milestones, graph/over-scatter, histogram/normalized, histogram2dcontour/constraint, histogram2dcontour/over-scatter, image/dates, image/source, interaction/touch, layout-images/background, layout-images/logo, layout/climate-grid, layout/grid-coupled, layout/grid-independent, layout/make-subplots, layout/service-health-grid, legends/group-titles, legends/grouped-dashboard, legends/multiple, legends/overlay-columns, legends/scrolling, line/basic, line/dashes, line/gaps, line/many-series, line/spline, line/step, line/with-bars, locales/german-time-series, log/colorbar, log/log-log, log/minor-grid, log/semilog-y, ohlc/indicators, polar/mixed, recipes/candlestick-volume, recipes/dot-plot, recipes/dumbbell, recipes/error-bands, recipes/lollipop, recipes/stacked-totals, scatter/clusters, scatter/custom-symbols, scatter/image-sprites, scatter/interactive, scatter/marker-symbols, scatter/style-rules-colorscale, scatter/style-rules, scene/subplots, selections/box, selections/lasso, shapes/basic, shapes/paths, shapes/pixel-size, table/interaction, text/rich-text-labels, timeseries/business-hours, timeseries/date-formatting, timeseries/minute-bars, timeseries/period-alignment, timeseries/range-slider, timeseries/unified-hover, view3d/interactive, view3d/scatter

Generated from the attribute schema (255 entries). Machine-readable: plot-schema.json.

Attribute tree

• type
• visible
• name
• uid
• showlegend
• legend
• legendgroup
• hovertext
• hoverinfo
• hovertemplate
• hoverlabel

  • bgcolor
  • bordercolor
  • font

    • family
    • size
    • color
  • align
  • namelength
• selectedpoints
• legendrank
• legendwidth
• legendgrouptitle

  • text
  • font

    • family
    • size
    • color
    • weight
    • style
• opacity
• meta
• customdata
• ids
• dataset
• uirevision
• styleRules
• xaxis
• yaxis
• x
• x0
• dx
• xperiod
• xperiod0
• xperiodalignment
• y
• y0
• dy
• yperiod
• yperiod0
• yperiodalignment
• mode
• text
• texttemplate
• textposition
• textfont

  • family
  • size
  • color
  • weight
  • style
• line

  • color
  • width
  • dash
  • shape
  • smoothing
  • simplify
• connectgaps
• fill
• fillcolor
• fillgradient

  • type
  • start
  • stop
  • colorscale
• fillpattern

  • shape
  • fillmode
  • bgcolor
  • fgcolor
  • fgopacity
  • size
  • solidity
• stackgroup
• orientation
• groupnorm
• stackgaps
• hoveron
• marker

  • color
  • colorscale
  • autocolorscale
  • reversescale
  • cauto
  • cmin
  • cmax
  • cmid
  • showscale
  • colorbar

    • orientation
    • thicknessmode
    • thickness
    • lenmode
    • len
    • x
    • xref
    • xanchor
    • xpad
    • y
    • yref
    • yanchor
    • ypad
    • outlinecolor
    • outlinewidth
    • bordercolor
    • borderwidth
    • bgcolor
    • tickmode
    • nticks
    • tick0
    • dtick
    • tickvals
    • ticktext
    • ticks
    • ticklen
    • tickwidth
    • tickcolor
    • ticklabelposition
    • ticklabeloverflow
    • ticklabelstep
    • showticklabels
    • tickfont

      • family
      • size
      • color
      • weight
      • style
      • variant
      • textcase
      • lineposition
      • shadow
    • tickangle
    • tickformat
    • tickprefix
    • showtickprefix
    • ticksuffix
    • showticksuffix
    • separatethousands
    • exponentformat
    • minexponent
    • showexponent
    • title

      • text
      • font

        • family
        • size
        • color
        • weight
        • style
        • variant
        • textcase
        • lineposition
        • shadow
      • side
  • coloraxis
  • size
  • sizemode
  • sizeref
  • sizemin
  • symbol
  • image
  • opacity
  • angle
  • maxdisplayed
  • line

    • color
    • colorscale
    • autocolorscale
    • reversescale
    • cauto
    • cmin
    • cmax
    • cmid
    • coloraxis
    • width
• selected

  • marker

    • opacity
    • color
    • size
  • textfont

    • color
• unselected

  • marker

    • opacity
    • color
    • size
  • textfont

    • color
• error_x

  • visible
  • type
  • symmetric
  • array
  • arrayminus
  • value
  • valueminus
  • traceref
  • tracerefminus
  • thickness
  • width
  • color
  • copy_ystyle
• error_y

  • visible
  • type
  • symmetric
  • array
  • arrayminus
  • value
  • valueminus
  • traceref
  • tracerefminus
  • thickness
  • width
  • color
• zorder
• depth
• bevel

  • size
  • segments
• material

  • type
  • roughness
  • metalness
  • shininess
  • specular
  • emissive
  • emissiveintensity
  • reflectivity
  • envmapintensity
  • clearcoat
  • clearcoatroughness
  • transmission
  • ior
  • thickness
  • sheen
  • sheencolor
  • sheenroughness
  • iridescence
  • steps
  • matcap
  • castshadow
  • receiveshadow

type string

Trace type, e.g. 'scatter'. Defaults to 'scatter'.

• Type: string (non-empty)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

visible enumerated

Whether the trace is drawn. legendonly hides it but keeps its (toggleable) legend entry.

• Type: enumerated
• Values: true | false | "legendonly"
• Default: true
• Array OK: no
• Edit type: calc
• Animatable: no

name string

Trace name shown in the legend and hover labels. Defaults to trace N.

• Type: string
• Default: none
• Array OK: no
• Edit type: legend+plot
• Animatable: no

uid string

Stable identity used to match traces across updates, so reordered traces are moved instead of rebuilt.

• Type: string
• Default: none
• Array OK: no
• Edit type: plot
• Animatable: no

showlegend boolean

Whether this trace has a legend entry.

• Type: boolean
• Default: true
• Array OK: no
• Edit type: legend+layout
• Animatable: no

legend subplotid

The legend this trace's item is shown in: 'legend' (layout.legend), 'legend2' (layout.legend2), ….

• Type: subplotid (legend, legend2, legend3, …)
• Default: "legend"
• Array OK: no
• Edit type: legend+layout
• Animatable: no

legendgroup string

Traces in the same legend group toggle together.

• Type: string
• Default: ""
• Array OK: no
• Edit type: legend
• Animatable: no

hovertext string

Hover text per point; defaults to text.

• Type: string
• Default: ""
• Array OK: yes (one value per point)
• Edit type: style
• Animatable: no

hoverinfo flaglist

Which fields hover labels show; 'skip' also turns hover events off for this trace. Default 'all'.

• Type: flaglist
• Flags: "x", "y", "z", "text", "name" (combine with +)
• Also accepts: "all" | "none" | "skip"
• Default: none
• Array OK: yes (one value per point)
• Edit type: none
• Animatable: no

hovertemplate string

Template for hover labels, e.g. '%{x}: %{y:.2f}<extra></extra>' (d3-format / d3-time-format after : / |). Overrides hoverinfo.

• Type: string
• Default: none
• Array OK: yes (one value per point)
• Edit type: none
• Animatable: no

hoverlabel

Hover label style for this trace. Unset fields fall back to layout.hoverlabel (so there are no trace-level defaults).

• Type: object
• Edit type: none

hoverlabel.bgcolor color

Label background. Default: the point color.

• Type: color
• Default: none
• Array OK: yes (one value per point)
• Edit type: none
• Animatable: no

hoverlabel.bordercolor color

Label border. Default: contrasting with the background.

• Type: color
• Default: none
• Array OK: yes (one value per point)
• Edit type: none
• Animatable: no

hoverlabel.font

Label font.

• Type: object
• Edit type: none

hoverlabel.font.family string

Font family.

• Type: string
• Default: none
• Array OK: yes (one value per point)
• Edit type: none
• Animatable: no

hoverlabel.font.size number

Font size in px.

• Type: number ≥ 1
• Default: none
• Array OK: yes (one value per point)
• Edit type: none
• Animatable: no

hoverlabel.font.color color

Font color.

• Type: color
• Default: none
• Array OK: yes (one value per point)
• Edit type: none
• Animatable: no

hoverlabel.align enumerated

Text alignment inside labels.

• Type: enumerated
• Values: "left" | "right" | "auto"
• Default: none
• Array OK: yes (one value per point)
• Edit type: none
• Animatable: no

hoverlabel.namelength integer

Characters of the trace name shown (-1: all, 0: none).

• Type: integer ≥ -1
• Default: none
• Array OK: yes (one value per point)
• Edit type: none
• Animatable: no

selectedpoints any

Indices of the selected points (set by box/lasso selection, or programmatically). null clears the selection.

• Type: any
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

legendrank number

Sort key for legend entries: lower ranks come first (top, or left). Ties keep trace order; traces default to 1000.

• Type: number
• Default: 1000
• Array OK: no
• Edit type: legend
• Animatable: no

legendwidth number

Width of this trace's item in horizontal legends, overriding legend.entrywidth (same units). Default: its text's.

• Type: number ≥ 0
• Default: none
• Array OK: no
• Edit type: legend
• Animatable: no

legendgrouptitle

Title of the legend group this trace belongs to.

• Type: object
• Edit type: legend

legendgrouptitle.text string

Title heading this trace's legend group.

• Type: string
• Default: ""
• Array OK: no
• Edit type: legend
• Animatable: no

legendgrouptitle.font

Group title font. Unset fields come from legend.grouptitlefont.

• Type: object
• Edit type: legend

legendgrouptitle.font.family string

Font family.

• Type: string
• Default: none
• Array OK: no
• Edit type: legend
• Animatable: no

legendgrouptitle.font.size number

Font size in px.

• Type: number ≥ 1
• Default: none
• Array OK: no
• Edit type: legend
• Animatable: no

legendgrouptitle.font.color color

Font color.

• Type: color
• Default: none
• Array OK: no
• Edit type: legend
• Animatable: no

legendgrouptitle.font.weight integer

Font weight: a CSS numeric weight (1–1000), normal or bold.

• Type: integer from 1 to 1000, or "normal" | "bold"
• Default: none
• Array OK: no
• Edit type: legend
• Animatable: no

legendgrouptitle.font.style enumerated

Font style.

• Type: enumerated
• Values: "normal" | "italic"
• Default: none
• Array OK: no
• Edit type: legend
• Animatable: no

opacity number

Opacity of the whole trace.

• Type: number from 0 to 1
• Default: 1
• Array OK: no
• Edit type: style
• Animatable: yes

meta any

Arbitrary user data, available in text templates as %{meta}.

• Type: any
• Default: none
• Array OK: yes (one value per point)
• Edit type: plot
• Animatable: no

customdata data_array

Per-point user data, returned in events and available in hover templates.

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

ids data_array

Per-point ids used to match points across animation frames.

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

dataset string

Name of a figure-level dataset (figure.datasets). Data arrays, and per-point attributes whose values cannot start with @ (such as colors and sizes), may then reference its columns as '@column'; on string attributes such as text, '@…' stays literal text.

• Type: string (non-empty)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

uirevision any

While unchanged, user interaction state for this trace (legend visibility, selections) is kept across updates.

• Type: any
• Default: none
• Array OK: no
• Edit type: none
• Animatable: no

styleRules any

Conditional per-point styling as JSON (plan E8.5): [{ when: { y: { gt: 10 } }, set: { 'marker.color': 'gold' } }]. when tests fields of the point ('y', 'customdata[1]', 'pointNumber', …) with eq, ne, gt, gte, lt, lte, in, nin, between, regex, and, or and not; set gives per-point (arrayOk) attributes a value on the matching points. Later rules win; other points keep the trace's own value.

• Type: any
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

xaxis subplotid

The x axis this trace is plotted against: 'x' → layout.xaxis, 'x2' → layout.xaxis2.

• Type: subplotid (x, x2, x3, …)
• Default: "x"
• Array OK: no
• Edit type: calc
• Animatable: no

yaxis subplotid

The y axis this trace is plotted against: 'y' → layout.yaxis, 'y2' → layout.yaxis2.

• Type: subplotid (y, y2, y3, …)
• Default: "y"
• Array OK: no
• Edit type: calc
• Animatable: no

x data_array

x coordinates: numbers, dates or category names depending on the axis type.

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

x0 any

Starting x coordinate when x is not given: point i is at x0 + i·dx.

• Type: any
• Default: 0
• Array OK: no
• Edit type: calc
• Animatable: no

dx number

Step between implicit x coordinates (see x0).

• Type: number
• Default: 1
• Array OK: no
• Edit type: calc
• Animatable: no

xperiod any

Only on date or linear x axes: snap each x value to its period of this length (ms, or 'M<n>' months on date axes), positioned per xperiodalignment.

• Type: any
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

xperiod0 any

A period boundary for xperiod. Default: 2000-01-01 on date axes (a Sunday for weekly periods), 0 otherwise.

• Type: any
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

xperiodalignment enumerated

Where points sit within their xperiod.

• Type: enumerated
• Values: "start" | "middle" | "end"
• Default: "middle"
• Array OK: no
• Edit type: calc
• Animatable: no

y data_array

y coordinates: numbers, dates or category names depending on the axis type.

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

y0 any

Starting y coordinate when y is not given: point i is at y0 + i·dy.

• Type: any
• Default: 0
• Array OK: no
• Edit type: calc
• Animatable: no

dy number

Step between implicit y coordinates (see y0).

• Type: number
• Default: 1
• Array OK: no
• Edit type: calc
• Animatable: no

yperiod any

Only on date or linear y axes: snap each y value to its period of this length (ms, or 'M<n>' months on date axes), positioned per yperiodalignment.

• Type: any
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

yperiod0 any

A period boundary for yperiod. Default: 2000-01-01 on date axes (a Sunday for weekly periods), 0 otherwise.

• Type: any
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

yperiodalignment enumerated

Where points sit within their yperiod.

• Type: enumerated
• Values: "start" | "middle" | "end"
• Default: "middle"
• Array OK: no
• Edit type: calc
• Animatable: no

mode flaglist

Drawing mode. Defaults to 'lines+markers' below 20 points, else 'lines' (Plotly rule).

• Type: flaglist
• Flags: "lines", "markers", "text" (combine with +)
• Also accepts: "none"
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

text string

Text per point: the labels of mode text, and hover text.

• Type: string
• Default: ""
• Array OK: yes (one value per point)
• Edit type: plot
• Animatable: no

texttemplate string

Template for the text labels, e.g. '%{y:.2f}' or '%{x|%b %d}' (d3-format / d3-time-format after : / |). Keys: x, y, text, customdata, marker.size, marker.color, meta. Overrides text.

• Type: string
• Default: ""
• Array OK: yes (one value per point)
• Edit type: plot
• Animatable: no

textposition enumerated

Where text labels sit relative to their point (and marker), or one per point.

• Type: enumerated
• Values: "top left" | "top center" | "top right" | "middle left" | "middle center" | "middle right" | "bottom left" | "bottom center" | "bottom right"
• Default: "middle center"
• Array OK: yes (one value per point)
• Edit type: plot
• Animatable: no

textfont

Font of the text labels (mode text). Defaults to layout.font.

• Type: object
• Edit type: plot

textfont.family string

CSS font family of the text labels, or one per point.

• Type: string (non-empty)
• Default: none
• Array OK: yes (one value per point)
• Edit type: plot
• Animatable: no

textfont.size number

Font size in CSS px, or one per point.

• Type: number ≥ 1
• Default: none
• Array OK: yes (one value per point)
• Edit type: plot
• Animatable: no

textfont.color color

Text color, or one per point.

• Type: color
• Default: none
• Array OK: yes (one value per point)
• Edit type: style
• Animatable: no

textfont.weight integer

Font weight: a CSS numeric weight, normal or bold.

• Type: integer from 1 to 1000, or "normal" | "bold"
• Default: none
• Array OK: no
• Edit type: plot
• Animatable: no

textfont.style enumerated

Font style.

• Type: enumerated
• Values: "normal" | "italic"
• Default: none
• Array OK: no
• Edit type: plot
• Animatable: no

line

Line style (mode lines). shape and smoothing also shape fills.

• Type: object
• Edit type: plot

line.color color

Line color. Defaults to the marker color (when a single color) or the colorway.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

line.width number

Line width in CSS px.

• Type: number ≥ 0
• Default: 2
• Array OK: no
• Edit type: style
• Animatable: no

line.dash string

Dash style: 'solid', 'dot', 'dash', 'longdash', 'dashdot', 'longdashdot', or a dash list such as '5px,10px,2px'.

• Type: string
• Default: "solid"
• Array OK: no
• Edit type: style
• Animatable: no

line.shape enumerated

Interpolation between points: straight, 'spline' (centripetal Catmull-Rom, see smoothing), or steps ('hv': horizontal then vertical, …).

• Type: enumerated
• Values: "linear" | "spline" | "hv" | "vh" | "hvh" | "vhv"
• Default: "linear"
• Array OK: no
• Edit type: plot+crossTraceCalc
• Animatable: no

line.smoothing number

Spline tension for shape: 'spline': 0 is straight, 1.3 the smoothest.

• Type: number from 0 to 1.3
• Default: 1
• Array OK: no
• Edit type: plot+crossTraceCalc
• Animatable: no

line.simplify boolean

Decimate dense monotonic lines to at most 4 vertices per pixel column (min/max, visually lossless). Recomputed when zooming changes the scale.

• Type: boolean
• Default: true
• Array OK: no
• Edit type: plot
• Animatable: no

connectgaps boolean

Connect lines across missing (null, NaN) points instead of breaking them.

• Type: boolean
• Default: false
• Array OK: no
• Edit type: plot+crossTraceCalc
• Animatable: no

fill enumerated

Area to fill with fillcolor. Default 'none', or 'tonexty' ('tonextx' for orientation: 'h') in a stackgroup. 'tozeroy' / 'tozerox' fill to y = 0 / x = 0; 'tonexty' / 'tonextx' fill to the previous trace on the subplot (in the same stackgroup), joining the end points with straight lines, and act like 'tozero…' without one; 'toself' closes the line (each segment when it has gaps) into a shape; 'tonext' fills between this trace and the previous one when one encloses the other (like 'toself' without one). Fills follow line.shape.

• Type: enumerated
• Values: "none" | "tozeroy" | "tozerox" | "tonexty" | "tonextx" | "toself" | "tonext"
• Default: "none"
• Array OK: no
• Edit type: calc
• Animatable: no

fillcolor color

Fill color. Default: the line color (else the marker color, else the colorway color) at half opacity.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

fillgradient

A color gradient drawn instead of fillcolor (which still colors hover labels).

• Type: object
• Edit type: plot

fillgradient.type enumerated

Gradient direction: along x ('horizontal'), along y ('vertical'), or outwards from the center of the fill's bounding box ('radial').

• Type: enumerated
• Values: "radial" | "horizontal" | "vertical" | "none"
• Default: "none"
• Array OK: no
• Edit type: plot
• Animatable: no

fillgradient.start number

Where the gradient starts (colorscale position 0), as a value on the axis of the gradient direction. Default: the lowest value of the fill along that axis. Ignored for radial.

• Type: number
• Default: none
• Array OK: no
• Edit type: plot
• Animatable: no

fillgradient.stop number

Where the gradient ends (colorscale position 1), as a value on the axis of the gradient direction. Default: the highest value of the fill along that axis. Ignored for radial.

• Type: number
• Default: none
• Array OK: no
• Edit type: plot
• Animatable: no

fillgradient.colorscale colorscale

Gradient colors: a colorscale from the lowest to the highest value along the gradient direction, or from the center outwards for radial.

• Type: colorscale
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

fillpattern

Hatch pattern of the area fill (drawn in screen px, for print and grayscale).

• Type: object
• Edit type: style

fillpattern.shape enumerated

Hatch shape: diagonal ('/', '\\', 'x'), horizontal and vertical ('-', '|', '+') lines or dots ('.'); '' for none.

• Type: enumerated
• Values: "" | "/" | "\\" | "x" | "-" | "|" | "+" | "."
• Default: ""
• Array OK: no
• Edit type: style
• Animatable: no

fillpattern.fillmode enumerated

'replace': the pattern in the fill color on bgcolor (default transparent) replaces the fill; 'overlay': the pattern is drawn over the fill color, in its contrast color at half opacity by default.

• Type: enumerated
• Values: "replace" | "overlay"
• Default: "replace"
• Array OK: no
• Edit type: style
• Animatable: no

fillpattern.bgcolor color

Pattern background. Default: the fill color with fillmode: 'overlay', else transparent.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

fillpattern.fgcolor color

Pattern color. Default: the fill color with fillmode: 'replace', else white or dark grey, whichever contrasts with bgcolor.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

fillpattern.fgopacity number

Opacity of the pattern color. Default 0.5 with fillmode: 'overlay', else 1.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

fillpattern.size number

Size of the pattern's tiles in CSS px: the spacing of its lines or dots.

• Type: number ≥ 0
• Default: 8
• Array OK: no
• Edit type: style
• Animatable: no

fillpattern.solidity number

Fraction of the area the pattern covers: 0 shows only the background, 1 only the pattern color.

• Type: number from 0 to 1
• Default: 0.3
• Array OK: no
• Edit type: style
• Animatable: no

stackgroup string

Stack this trace on the previous traces of the same group on its subplot: their y values add up (x values for orientation: 'h'). Stacking turns fill on ('tonexty' / 'tonextx') and makes mode default to 'lines'. Only numeric (linear or log) value axes stack.

• Type: string
• Default: ""
• Array OK: no
• Edit type: calc
• Animatable: no

orientation enumerated

Stacking direction in a stackgroup: 'v' adds y values, 'h' x values. The first trace of the group that sets it decides; default 'h' when only x is given, else 'v'.

• Type: enumerated
• Values: "v" | "h"
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

groupnorm enumerated

Normalize each position's stackgroup total to 1 ('fraction') or 100 ('percent'). The first trace of the group that sets it decides.

• Type: enumerated
• Values: "" | "fraction" | "percent"
• Default: ""
• Array OK: no
• Edit type: calc
• Animatable: no

stackgaps enumerated

What a stackgroup trace contributes where other traces of the group have a position it lacks (or where its value is missing): zero, or a value interpolated linearly between its neighbors (constant beyond its ends). The first trace of the group that sets it decides.

• Type: enumerated
• Values: "infer zero" | "interpolate"
• Default: "infer zero"
• Array OK: no
• Edit type: calc
• Animatable: no

hoveron flaglist

What hover reacts to: points (markers, line vertices) and/or the filled area, which reports the trace. Default 'fills' for 'toself' / 'tonext' fills without markers or text, else 'points'. Fills hover (in every hovermode) only when no point is under the pointer.

• Type: flaglist
• Flags: "points", "fills" (combine with +)
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker

Marker style (mode markers).

• Type: object
• Edit type: calc

marker.color color

Marker fill color, one CSS color per point, or numbers mapped through colorscale. Defaults to the colorway.

• Type: color
• Default: none
• Array OK: yes (one value per point)
• Edit type: style
• Animatable: yes

marker.colorscale colorscale

Colorscale for numeric marker.color values: a name ('Viridis', 'RdBu', …), a list of colors, or [position, color] stops from 0 to 1.

• Type: colorscale
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.autocolorscale boolean

Pick the colorscale from the sign of the color domain (Reds for ≥ 0, Blues for ≤ 0, RdBu across 0). Defaults to true unless colorscale is given.

• Type: boolean
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.reversescale boolean

Reverse the colorscale (the lowest value gets the last color).

• Type: boolean
• Default: false
• Array OK: no
• Edit type: style
• Animatable: no

marker.cauto boolean

Compute the color domain from the numeric marker.color values. Defaults to false when both cmin and cmax are given.

• Type: boolean
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.cmin number

Value mapped to the first colorscale color (with cmax; turns cauto off).

• Type: number
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.cmax number

Value mapped to the last colorscale color (with cmin; turns cauto off).

• Type: number
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.cmid number

With cauto, widen the automatic domain so it is symmetric around this value (diverging data).

• Type: number
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.showscale boolean

Show a colorbar for this colorscale (drawn by the colorbar component, plan E5.3).

• Type: boolean
• Default: false
• Array OK: no
• Edit type: colorbars
• Animatable: no

marker.colorbar

The colorbar of this colorscale (plan E5.3).

• Type: object
• Edit type: colorbars+layout

marker.colorbar.orientation enumerated

Vertical bar (v, beside the plot) or horizontal bar (h, above or below).

• Type: enumerated
• Values: "h" | "v"
• Default: "v"
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.thicknessmode enumerated

Unit of thickness: px, or a fraction of the plot width (v) / height (h).

• Type: enumerated
• Values: "fraction" | "pixels"
• Default: "pixels"
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.thickness number

Thickness of the color bar.

• Type: number ≥ 0
• Default: 30
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.lenmode enumerated

Unit of len: px, or a fraction of the plot height (v) / width (h).

• Type: enumerated
• Values: "fraction" | "pixels"
• Default: "fraction"
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.len number

Length of the colorbar along its axis, padding included (ypad / xpad).

• Type: number ≥ 0
• Default: 1
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.x number

Horizontal position (xref fraction). Defaults to 1.02 (v, paper), 1 (v, container) or 0.5 (h).

• Type: number
• Default: none
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.xref enumerated

Reference of x: the plot area (paper) or the whole figure.

• Type: enumerated
• Values: "container" | "paper"
• Default: "paper"
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.xanchor enumerated

Which side of the colorbar sits at x. Defaults to left (v, paper), right (v, container) or center (h).

• Type: enumerated
• Values: "left" | "center" | "right"
• Default: none
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.xpad number

Horizontal padding, px.

• Type: number ≥ 0
• Default: 10
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.y number

Vertical position (yref fraction). Defaults to 0.5 (v), 1.02 (h, paper) or 1 (h, container).

• Type: number
• Default: none
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.yref enumerated

Reference of y: the plot area (paper) or the whole figure.

• Type: enumerated
• Values: "container" | "paper"
• Default: "paper"
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.yanchor enumerated

Which side of the colorbar sits at y. Defaults to middle (v), bottom (h, paper) or top (h, container).

• Type: enumerated
• Values: "top" | "middle" | "bottom"
• Default: none
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.ypad number

Vertical padding, px.

• Type: number ≥ 0
• Default: 10
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.outlinecolor color

Color of the outline around the bar.

• Type: color
• Default: "#444"
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.outlinewidth number

Outline width, px.

• Type: number ≥ 0
• Default: 1
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.bordercolor color

Border color of the colorbar box.

• Type: color
• Default: "#444"
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.borderwidth number

Border width of the box, px.

• Type: number ≥ 0
• Default: 0
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.bgcolor color

Background of the box.

• Type: color
• Default: "rgba(0, 0, 0, 0)"
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.tickmode enumerated

auto picks up to nticks round ticks; linear places ticks from tick0 every dtick; array uses tickvals/ticktext; sync aligns with the overlaid axis (reserved; behaves as auto). Defaults to array when tickvals is set, linear when dtick is set, else auto.

• Type: enumerated
• Values: "auto" | "linear" | "array" | "sync"
• Default: none
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.nticks integer

Maximum number of ticks for tickmode: auto (the actual number may be lower so steps stay round). 0 picks it from the axis length.

• Type: integer ≥ 0
• Default: 0
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.tick0 any

Position of one tick for tickmode: linear (data units; a date on date axes, an exponent on log axes unless dtick is L<f>). Defaults to 0, or 2000-01-01 on date axes.

• Type: any
• Default: none
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.dtick any

Tick step. Linear axes: a positive number. Log axes: an integer n (a tick every n decades), L<f> (linear steps of f in data units, e.g. L0.5), D1 (every digit) or D2 (1, 2 and 5). Date axes: milliseconds, or M<n> for n months (M12 for years).

• Type: any
• Default: none
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.tickvals data_array

Tick positions for tickmode: array (data units).

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.ticktext data_array

Tick labels for tickvals. Missing entries are formatted as usual.

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.ticks enumerated

Draw tick marks outside or inside the plot area, or not at all ('').

• Type: enumerated
• Values: "outside" | "inside" | ""
• Default: ""
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.ticklen number

Tick length in px.

• Type: number ≥ 0
• Default: 5
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.tickwidth number

Tick width in px.

• Type: number ≥ 0
• Default: 1
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.tickcolor color

Tick color. Defaults to color.

• Type: color
• Default: "#444"
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.ticklabelposition enumerated

Tick labels outside the bar (away from it) or inside (over it); top/bottom (v) or left/right (h) move them beside their tick.

• Type: enumerated
• Values: "outside" | "inside" | "outside top" | "inside top" | "outside bottom" | "inside bottom" | "outside left" | "inside left" | "outside right" | "inside right"
• Default: "outside"
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.ticklabeloverflow enumerated

Hide labels past the figure or past the bar. Defaults to hide past domain for inside labels, else hide past div.

• Type: enumerated
• Values: "allow" | "hide past div" | "hide past domain"
• Default: none
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.ticklabelstep integer

Label every n-th tick only (tickmode auto and linear).

• Type: integer ≥ 1
• Default: 1
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.showticklabels boolean

Show tick labels.

• Type: boolean
• Default: true
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.tickfont

Tick-label font. Defaults to layout.font.

• Type: object
• Edit type: layout+plot

marker.colorbar.tickfont.family string

CSS font-family list. The renderer uses the first family it can load and falls back through the list.

• Type: string (non-empty)
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.tickfont.size number

Font size in CSS pixels.

• Type: number ≥ 1
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.tickfont.color color

Text color.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.colorbar.tickfont.weight integer

Font weight: a CSS numeric weight (1–1000), normal or bold.

• Type: integer from 1 to 1000, or "normal" | "bold"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.tickfont.style enumerated

Font style.

• Type: enumerated
• Values: "normal" | "italic"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.tickfont.variant enumerated

Capitals variant (CSS font-variant-caps). The SDF text renderer approximates small and petite caps with uppercase letters at a reduced size.

• Type: enumerated
• Values: "normal" | "small-caps" | "all-small-caps" | "all-petite-caps" | "petite-caps" | "unicase"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.tickfont.textcase enumerated

Letter case transform: upper, lower, word caps (first letter of each word), or normal.

• Type: enumerated
• Values: "normal" | "word caps" | "upper" | "lower"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.tickfont.lineposition flaglist

Text decoration: under, over and/or through joined with + (e.g. under+over), or none.

• Type: flaglist
• Flags: "under", "over", "through" (combine with +)
• Also accepts: "none"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.tickfont.shadow string

CSS text-shadow behind the text (2px 2px 3px black; only the first shadow is drawn), none, or auto for a thin halo in the contrast color of the text.

• Type: string
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.tickangle angle

Tick-label rotation in degrees. auto rotates x-axis labels by the first autotickangles entry that avoids overlap.

• Type: angle (degrees), or "auto"
• Default: "auto"
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.tickformat string

Tick-label format: a d3-format specifier for numbers (.2f, ~s, $,) or a d3-time-format specifier for dates (%b %Y), plus %{n}f for n digits of fractional seconds and %h for the half year. Empty picks a format automatically.

• Type: string
• Default: ""
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.tickprefix string

Text before each tick label.

• Type: string
• Default: ""
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.showtickprefix enumerated

Which tick labels get tickprefix.

• Type: enumerated
• Values: "all" | "first" | "last" | "none"
• Default: "all"
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.ticksuffix string

Text after each tick label.

• Type: string
• Default: ""
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.showticksuffix enumerated

Which tick labels get ticksuffix.

• Type: enumerated
• Values: "all" | "first" | "last" | "none"
• Default: "all"
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.separatethousands boolean

Always separate thousands (1,000). By default only numbers with 5 or more integer digits are separated.

• Type: boolean
• Default: false
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.exponentformat enumerated

How large and small numbers are written: none (1000000), e (1e+6), E (1E+6), power (1×10⁶), SI (1M), B (like SI but 1B for 10⁹).

• Type: enumerated
• Values: "none" | "e" | "E" | "power" | "SI" | "B"
• Default: "B"
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.minexponent number

Smallest decimal exponent written in exponent form (SI/B and exponent formats); smaller magnitudes are written out in full.

• Type: number ≥ 0
• Default: 3
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.showexponent enumerated

Which tick labels show the exponent.

• Type: enumerated
• Values: "all" | "first" | "last" | "none"
• Default: "all"
• Array OK: no
• Edit type: colorbars+layout
• Animatable: no

marker.colorbar.title

Colorbar title.

• Type: object
• Edit type: colorbars+layout

marker.colorbar.title.text string

Colorbar title.

• Type: string
• Default: ""
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.colorbar.title.font

Title font. Defaults to layout.font with the tick-label family and 1.2 × its size.

• Type: object
• Edit type: layout+plot

marker.colorbar.title.font.family string

CSS font-family list. The renderer uses the first family it can load and falls back through the list.

• Type: string (non-empty)
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.title.font.size number

Font size in CSS pixels.

• Type: number ≥ 1
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.title.font.color color

Text color.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.colorbar.title.font.weight integer

Font weight: a CSS numeric weight (1–1000), normal or bold.

• Type: integer from 1 to 1000, or "normal" | "bold"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.title.font.style enumerated

Font style.

• Type: enumerated
• Values: "normal" | "italic"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.title.font.variant enumerated

Capitals variant (CSS font-variant-caps). The SDF text renderer approximates small and petite caps with uppercase letters at a reduced size.

• Type: enumerated
• Values: "normal" | "small-caps" | "all-small-caps" | "all-petite-caps" | "petite-caps" | "unicase"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.title.font.textcase enumerated

Letter case transform: upper, lower, word caps (first letter of each word), or normal.

• Type: enumerated
• Values: "normal" | "word caps" | "upper" | "lower"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.title.font.lineposition flaglist

Text decoration: under, over and/or through joined with + (e.g. under+over), or none.

• Type: flaglist
• Flags: "under", "over", "through" (combine with +)
• Also accepts: "none"
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.title.font.shadow string

CSS text-shadow behind the text (2px 2px 3px black; only the first shadow is drawn), none, or auto for a thin halo in the contrast color of the text.

• Type: string
• Default: none
• Array OK: no
• Edit type: layout+plot (inherited)
• Animatable: no

marker.colorbar.title.side enumerated

Where the title goes relative to the bar. Defaults to top (v) or right (h).

• Type: enumerated
• Values: "right" | "top" | "bottom"
• Default: none
• Array OK: no
• Edit type: colorbars+layout (inherited)
• Animatable: no

marker.coloraxis subplotid

Share a colorscale and domain with other traces through layout.coloraxis ('coloraxis', 'coloraxis2', …). Overrides this container's colorscale attributes.

• Type: subplotid (coloraxis, coloraxis2, coloraxis3, …)
• Default: "coloraxis"
• Array OK: no
• Edit type: style
• Animatable: no

marker.size number

Marker diameter in CSS px, or one value per point (scaled by sizeref/sizemode).

• Type: number ≥ 0
• Default: 6
• Array OK: yes (one value per point)
• Edit type: calc
• Animatable: yes

marker.sizemode enumerated

How per-point size values become px: proportional to the diameter or to the area (bubble charts).

• Type: enumerated
• Values: "diameter" | "area"
• Default: "diameter"
• Array OK: no
• Edit type: calc
• Animatable: no

marker.sizeref number

Divides per-point size values (bubble charts; see sizemode).

• Type: number
• Default: 1
• Array OK: no
• Edit type: calc
• Animatable: no

marker.sizemin number

Minimum radius (px) of markers with per-point size values.

• Type: number ≥ 0
• Default: 0
• Array OK: no
• Edit type: calc
• Animatable: no

marker.symbol enumerated

Marker symbol: a name ('diamond-open'), a Plotly numeric code, a custom symbol registered with symbols.register (with the same -open / -dot variants), a 'text:…' glyph such as 'text:🚀', or one per point.

• Type: enumerated
• Values: "circle" | 0 | "0" | "circle-open" | 100 | "100" | "circle-dot" | 200 | "200" | "circle-open-dot" | 300 | "300" | "square" | 1 | "1" | "square-open" | 101 | "101" | "square-dot" | 201 | "201" | "square-open-dot" | 301 | "301" | "diamond" | 2 | "2" | "diamond-open" | 102 | "102" | "diamond-dot" | 202 | "202" | "diamond-open-dot" | 302 | "302" | "cross" | 3 | "3" | "cross-open" | 103 | "103" | "cross-dot" | 203 | "203" | "cross-open-dot" | 303 | "303" | "x" | 4 | "4" | "x-open" | 104 | "104" | "x-dot" | 204 | "204" | "x-open-dot" | 304 | "304" | "triangle-up" | 5 | "5" | "triangle-up-open" | 105 | "105" | "triangle-up-dot" | 205 | "205" | "triangle-up-open-dot" | 305 | "305" | "triangle-down" | 6 | "6" | "triangle-down-open" | 106 | "106" | "triangle-down-dot" | 206 | "206" | "triangle-down-open-dot" | 306 | "306" | "triangle-left" | 7 | "7" | "triangle-left-open" | 107 | "107" | "triangle-left-dot" | 207 | "207" | "triangle-left-open-dot" | 307 | "307" | "triangle-right" | 8 | "8" | "triangle-right-open" | 108 | "108" | "triangle-right-dot" | 208 | "208" | "triangle-right-open-dot" | 308 | "308" | "triangle-ne" | 9 | "9" | "triangle-ne-open" | 109 | "109" | "triangle-ne-dot" | 209 | "209" | "triangle-ne-open-dot" | 309 | "309" | "triangle-se" | 10 | "10" | "triangle-se-open" | 110 | "110" | "triangle-se-dot" | 210 | "210" | "triangle-se-open-dot" | 310 | "310" | "triangle-sw" | 11 | "11" | "triangle-sw-open" | 111 | "111" | "triangle-sw-dot" | 211 | "211" | "triangle-sw-open-dot" | 311 | "311" | "triangle-nw" | 12 | "12" | "triangle-nw-open" | 112 | "112" | "triangle-nw-dot" | 212 | "212" | "triangle-nw-open-dot" | 312 | "312" | "pentagon" | 13 | "13" | "pentagon-open" | 113 | "113" | "pentagon-dot" | 213 | "213" | "pentagon-open-dot" | 313 | "313" | "hexagon" | 14 | "14" | "hexagon-open" | 114 | "114" | "hexagon-dot" | 214 | "214" | "hexagon-open-dot" | 314 | "314" | "hexagon2" | 15 | "15" | "hexagon2-open" | 115 | "115" | "hexagon2-dot" | 215 | "215" | "hexagon2-open-dot" | 315 | "315" | "octagon" | 16 | "16" | "octagon-open" | 116 | "116" | "octagon-dot" | 216 | "216" | "octagon-open-dot" | 316 | "316" | "star" | 17 | "17" | "star-open" | 117 | "117" | "star-dot" | 217 | "217" | "star-open-dot" | 317 | "317" | "hexagram" | 18 | "18" | "hexagram-open" | 118 | "118" | "hexagram-dot" | 218 | "218" | "hexagram-open-dot" | 318 | "318" | "star-triangle-up" | 19 | "19" | "star-triangle-up-open" | 119 | "119" | "star-triangle-up-dot" | 219 | "219" | "star-triangle-up-open-dot" | 319 | "319" | "star-triangle-down" | 20 | "20" | "star-triangle-down-open" | 120 | "120" | "star-triangle-down-dot" | 220 | "220" | "star-triangle-down-open-dot" | 320 | "320" | "star-square" | 21 | "21" | "star-square-open" | 121 | "121" | "star-square-dot" | 221 | "221" | "star-square-open-dot" | 321 | "321" | "star-diamond" | 22 | "22" | "star-diamond-open" | 122 | "122" | "star-diamond-dot" | 222 | "222" | "star-diamond-open-dot" | 322 | "322" | "diamond-tall" | 23 | "23" | "diamond-tall-open" | 123 | "123" | "diamond-tall-dot" | 223 | "223" | "diamond-tall-open-dot" | 323 | "323" | "diamond-wide" | 24 | "24" | "diamond-wide-open" | 124 | "124" | "diamond-wide-dot" | 224 | "224" | "diamond-wide-open-dot" | 324 | "324" | "hourglass" | 25 | "25" | "hourglass-open" | 125 | "125" | "hourglass-dot" | 225 | "225" | "hourglass-open-dot" | 325 | "325" | "bowtie" | 26 | "26" | "bowtie-open" | 126 | "126" | "bowtie-dot" | 226 | "226" | "bowtie-open-dot" | 326 | "326" | "circle-cross" | 27 | "27" | "circle-cross-open" | 127 | "127" | "circle-cross-dot" | 227 | "227" | "circle-cross-open-dot" | 327 | "327" | "circle-x" | 28 | "28" | "circle-x-open" | 128 | "128" | "circle-x-dot" | 228 | "228" | "circle-x-open-dot" | 328 | "328" | "square-cross" | 29 | "29" | "square-cross-open" | 129 | "129" | "square-cross-dot" | 229 | "229" | "square-cross-open-dot" | 329 | "329" | "square-x" | 30 | "30" | "square-x-open" | 130 | "130" | "square-x-dot" | 230 | "230" | "square-x-open-dot" | 330 | "330" | "diamond-cross" | 31 | "31" | "diamond-cross-open" | 131 | "131" | "diamond-cross-dot" | 231 | "231" | "diamond-cross-open-dot" | 331 | "331" | "diamond-x" | 32 | "32" | "diamond-x-open" | 132 | "132" | "diamond-x-dot" | 232 | "232" | "diamond-x-open-dot" | 332 | "332" | "cross-thin" | 33 | "33" | "cross-thin-open" | 133 | "133" | "cross-thin-dot" | 233 | "233" | "cross-thin-open-dot" | 333 | "333" | "x-thin" | 34 | "34" | "x-thin-open" | 134 | "134" | "x-thin-dot" | 234 | "234" | "x-thin-open-dot" | 334 | "334" | "asterisk" | 35 | "35" | "asterisk-open" | 135 | "135" | "asterisk-dot" | 235 | "235" | "asterisk-open-dot" | 335 | "335" | "hash" | 36 | "36" | "hash-open" | 136 | "136" | "hash-dot" | 236 | "236" | "hash-open-dot" | 336 | "336" | "y-up" | 37 | "37" | "y-up-open" | 137 | "137" | "y-up-dot" | 237 | "237" | "y-up-open-dot" | 337 | "337" | "y-down" | 38 | "38" | "y-down-open" | 138 | "138" | "y-down-dot" | 238 | "238" | "y-down-open-dot" | 338 | "338" | "y-left" | 39 | "39" | "y-left-open" | 139 | "139" | "y-left-dot" | 239 | "239" | "y-left-open-dot" | 339 | "339" | "y-right" | 40 | "40" | "y-right-open" | 140 | "140" | "y-right-dot" | 240 | "240" | "y-right-open-dot" | 340 | "340" | "line-ew" | 41 | "41" | "line-ew-open" | 141 | "141" | "line-ew-dot" | 241 | "241" | "line-ew-open-dot" | 341 | "341" | "line-ns" | 42 | "42" | "line-ns-open" | 142 | "142" | "line-ns-dot" | 242 | "242" | "line-ns-open-dot" | 342 | "342" | "line-ne" | 43 | "43" | "line-ne-open" | 143 | "143" | "line-ne-dot" | 243 | "243" | "line-ne-open-dot" | 343 | "343" | "line-nw" | 44 | "44" | "line-nw-open" | 144 | "144" | "line-nw-dot" | 244 | "244" | "line-nw-open-dot" | 344 | "344" | "arrow-up" | 45 | "45" | "arrow-up-open" | 145 | "145" | "arrow-up-dot" | 245 | "245" | "arrow-up-open-dot" | 345 | "345" | "arrow-down" | 46 | "46" | "arrow-down-open" | 146 | "146" | "arrow-down-dot" | 246 | "246" | "arrow-down-open-dot" | 346 | "346" | "arrow-left" | 47 | "47" | "arrow-left-open" | 147 | "147" | "arrow-left-dot" | 247 | "247" | "arrow-left-open-dot" | 347 | "347" | "arrow-right" | 48 | "48" | "arrow-right-open" | 148 | "148" | "arrow-right-dot" | 248 | "248" | "arrow-right-open-dot" | 348 | "348" | "arrow-bar-up" | 49 | "49" | "arrow-bar-up-open" | 149 | "149" | "arrow-bar-up-dot" | 249 | "249" | "arrow-bar-up-open-dot" | 349 | "349" | "arrow-bar-down" | 50 | "50" | "arrow-bar-down-open" | 150 | "150" | "arrow-bar-down-dot" | 250 | "250" | "arrow-bar-down-open-dot" | 350 | "350" | "arrow-bar-left" | 51 | "51" | "arrow-bar-left-open" | 151 | "151" | "arrow-bar-left-dot" | 251 | "251" | "arrow-bar-left-open-dot" | 351 | "351" | "arrow-bar-right" | 52 | "52" | "arrow-bar-right-open" | 152 | "152" | "arrow-bar-right-dot" | 252 | "252" | "arrow-bar-right-open-dot" | 352 | "352" | "arrow" | 53 | "53" | "arrow-open" | 153 | "153" | "arrow-dot" | 253 | "253" | "arrow-open-dot" | 353 | "353" | "arrow-wide" | 54 | "54" | "arrow-wide-open" | 154 | "154" | "arrow-wide-dot" | 254 | "254" | "arrow-wide-open-dot" | 354 | "354"
• Default: "circle"
• Array OK: yes (one value per point)
• Edit type: style
• Animatable: no

marker.image string

Image sprites: a URL or data URI drawn instead of the symbol in a size × size square (keeping its aspect ratio), or one per point (empty entries keep the symbol). opacity applies; color and line do not. Cross-origin URLs need CORS headers.

• Type: string
• Default: none
• Array OK: yes (one value per point)
• Edit type: style
• Animatable: no

marker.opacity number

Marker opacity (multiplied by the trace opacity), or one per point. Default 1, 0.7 for bubbles.

• Type: number from 0 to 1
• Default: none
• Array OK: yes (one value per point)
• Edit type: style
• Animatable: yes

marker.angle angle

Marker rotation in degrees, clockwise, or one per point.

• Type: angle (degrees)
• Default: 0
• Array OK: yes (one value per point)
• Edit type: style
• Animatable: no

marker.maxdisplayed number

Draw at most this many markers (evenly strided over the data); 0 draws all.

• Type: number ≥ 0
• Default: 0
• Array OK: no
• Edit type: plot
• Animatable: no

marker.line

Marker outline.

• Type: object
• Edit type: style

marker.line.color color

Marker outline color, one per point, or numbers mapped through its colorscale.

• Type: color
• Default: none
• Array OK: yes (one value per point)
• Edit type: style
• Animatable: no

marker.line.colorscale colorscale

Colorscale for numeric marker.line.color values: a name ('Viridis', 'RdBu', …), a list of colors, or [position, color] stops from 0 to 1.

• Type: colorscale
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.line.autocolorscale boolean

Pick the colorscale from the sign of the color domain (Reds for ≥ 0, Blues for ≤ 0, RdBu across 0). Defaults to true unless colorscale is given.

• Type: boolean
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.line.reversescale boolean

Reverse the colorscale (the lowest value gets the last color).

• Type: boolean
• Default: false
• Array OK: no
• Edit type: style
• Animatable: no

marker.line.cauto boolean

Compute the color domain from the numeric marker.line.color values. Defaults to false when both cmin and cmax are given.

• Type: boolean
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.line.cmin number

Value mapped to the first colorscale color (with cmax; turns cauto off).

• Type: number
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.line.cmax number

Value mapped to the last colorscale color (with cmin; turns cauto off).

• Type: number
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.line.cmid number

With cauto, widen the automatic domain so it is symmetric around this value (diverging data).

• Type: number
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

marker.line.coloraxis subplotid

Share a colorscale and domain with other traces through layout.coloraxis ('coloraxis', 'coloraxis2', …). Overrides this container's colorscale attributes.

• Type: subplotid (coloraxis, coloraxis2, coloraxis3, …)
• Default: "coloraxis"
• Array OK: no
• Edit type: style
• Animatable: no

marker.line.width number

Marker outline width in CSS px, or one per point. Default 0, 1 for bubbles.

• Type: number ≥ 0
• Default: none
• Array OK: yes (one value per point)
• Edit type: style
• Animatable: no

selected

Style of selected points while a selection is active (box/lasso select, selectedpoints).

• Type: object
• Edit type: style

selected.marker

Marker style of selected points.

• Type: object
• Edit type: style

selected.marker.opacity number

Marker opacity of selected points.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

selected.marker.color color

Marker color of selected points.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

selected.marker.size number

Marker size (px) of selected points.

• Type: number ≥ 0
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

selected.textfont

Text style of selected points.

• Type: object
• Edit type: style

selected.textfont.color color

Text color of selected points.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

unselected

Style of unselected points while a selection is active (box/lasso select, selectedpoints).

• Type: object
• Edit type: style

unselected.marker

Marker style of unselected points.

• Type: object
• Edit type: style

unselected.marker.opacity number

Marker opacity of unselected points. Default: 0.2 × the marker opacity when no selected/unselected opacity is set.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

unselected.marker.color color

Marker color of unselected points.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

unselected.marker.size number

Marker size (px) of unselected points.

• Type: number ≥ 0
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

unselected.textfont

Text style of unselected points.

• Type: object
• Edit type: style

unselected.textfont.color color

Text color of unselected points.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

error_x

Error bars along the x axis.

• Type: object
• Edit type: calc

error_x.visible boolean

Whether this set of error bars is visible. Defaults to true when array or value is given, or type is sqrt.

• Type: boolean
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_x.type enumerated

How the bar lengths are computed: 'percent' of the underlying value, a 'constant', the 'sqrt' of the value, or per-point 'data' (array / arrayminus). Defaults to 'data' when array is given, else 'percent'.

• Type: enumerated
• Values: "percent" | "constant" | "sqrt" | "data"
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_x.symmetric boolean

Whether both directions use the same length. Defaults to true unless arrayminus (data) or valueminus (percent, constant) is given.

• Type: boolean
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_x.array data_array

Bar lengths in the positive x axis direction (or both directions when symmetric), one per point, for type 'data'.

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_x.arrayminus data_array

Bar lengths in the negative x axis direction, one per point, for type 'data' with symmetric: false.

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_x.value number

Bar length in the positive x axis direction (or both when symmetric): a percentage of the value for 'percent', an absolute length for 'constant'.

• Type: number ≥ 0
• Default: 10
• Array OK: no
• Edit type: calc
• Animatable: no

error_x.valueminus number

Bar length in the negative x axis direction when symmetric is false (see value).

• Type: number ≥ 0
• Default: 10
• Array OK: no
• Edit type: calc
• Animatable: no

error_x.traceref integer

Accepted for Plotly compatibility; has no effect.

• Type: integer ≥ 0
• Default: 0
• Array OK: no
• Edit type: calc
• Animatable: no

error_x.tracerefminus integer

Accepted for Plotly compatibility; has no effect.

• Type: integer ≥ 0
• Default: 0
• Array OK: no
• Edit type: calc
• Animatable: no

error_x.thickness number

Stroke width of the bars and their end caps, in CSS px.

• Type: number ≥ 0
• Default: 2
• Array OK: no
• Edit type: style
• Animatable: no

error_x.width number

Half-length of the cross-bar at each end, in CSS px (default 4). 0 hides the caps.

• Type: number ≥ 0
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

error_x.color color

Color of the bars. Defaults to the trace color.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

error_x.copy_ystyle boolean

Use the error_y color, thickness and width. Defaults to true when error_y is visible and none of those is set here.

• Type: boolean
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

error_y

Error bars along the y axis.

• Type: object
• Edit type: calc

error_y.visible boolean

Whether this set of error bars is visible. Defaults to true when array or value is given, or type is sqrt.

• Type: boolean
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_y.type enumerated

How the bar lengths are computed: 'percent' of the underlying value, a 'constant', the 'sqrt' of the value, or per-point 'data' (array / arrayminus). Defaults to 'data' when array is given, else 'percent'.

• Type: enumerated
• Values: "percent" | "constant" | "sqrt" | "data"
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_y.symmetric boolean

Whether both directions use the same length. Defaults to true unless arrayminus (data) or valueminus (percent, constant) is given.

• Type: boolean
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_y.array data_array

Bar lengths in the positive y axis direction (or both directions when symmetric), one per point, for type 'data'.

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_y.arrayminus data_array

Bar lengths in the negative y axis direction, one per point, for type 'data' with symmetric: false.

• Type: data_array (array or typed array)
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

error_y.value number

Bar length in the positive y axis direction (or both when symmetric): a percentage of the value for 'percent', an absolute length for 'constant'.

• Type: number ≥ 0
• Default: 10
• Array OK: no
• Edit type: calc
• Animatable: no

error_y.valueminus number

Bar length in the negative y axis direction when symmetric is false (see value).

• Type: number ≥ 0
• Default: 10
• Array OK: no
• Edit type: calc
• Animatable: no

error_y.traceref integer

Accepted for Plotly compatibility; has no effect.

• Type: integer ≥ 0
• Default: 0
• Array OK: no
• Edit type: calc
• Animatable: no

error_y.tracerefminus integer

Accepted for Plotly compatibility; has no effect.

• Type: integer ≥ 0
• Default: 0
• Array OK: no
• Edit type: calc
• Animatable: no

error_y.thickness number

Stroke width of the bars and their end caps, in CSS px.

• Type: number ≥ 0
• Default: 2
• Array OK: no
• Edit type: style
• Animatable: no

error_y.width number

Half-length of the cross-bar at each end, in CSS px (default 4). 0 hides the caps.

• Type: number ≥ 0
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

error_y.color color

Color of the bars. Defaults to the trace color.

• Type: color
• Default: none
• Array OK: no
• Edit type: style
• Animatable: no

zorder integer

Stacking order among the traces of a subplot: higher is drawn on top. At equal zorder, scatter traces draw above bars (Plotly’s layer order), then in trace order.

• Type: integer
• Default: 0
• Array OK: no
• Edit type: plot
• Animatable: no

depth any

Fill extrusion (Holochart extension, 2.5D, with fill): the thickness in CSS px of the slab the fill becomes, or a percentage of the plot area's width; lines, markers and labels are drawn on its front face. Filled traces share the depth, so stacked areas form layers of one slab. 0 (default) draws the trace flat.

• Type: any
• Default: 0
• Array OK: no
• Edit type: plot
• Animatable: no

bevel

Rounded edges of extruded shapes (with depth).

• Type: object
• Edit type: plot

bevel.size number

Radius of the rounded front and side edges, CSS px (at most half the size).

• Type: number ≥ 0
• Default: 0
• Array OK: no
• Edit type: plot
• Animatable: no

bevel.segments integer

Segments of each rounded edge.

• Type: integer from 1 to 16
• Default: 3
• Array OK: no
• Edit type: plot
• Animatable: no

material

The material of extruded shapes (with depth): Plotly figures keep the default, plotly.

• Type: object
• Edit type: calc

material.type enumerated

How surfaces are shaded. plotly: Plotly's lighting model. flat: unlit, colors as given. basic, lambert, phong, standard, physical, toon, matcap: the three.js material of that name, lit by the lights of the scene (scene.lighting) or of the 2.5D view.

• Type: enumerated
• Values: "plotly" | "flat" | "basic" | "lambert" | "phong" | "standard" | "physical" | "toon" | "matcap"
• Default: "plotly"
• Array OK: no
• Edit type: calc
• Animatable: no

material.roughness number

Surface roughness (standard, physical). Default: lighting.roughness.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.metalness number

How metallic the surface is (standard, physical). Default 0.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.shininess number

Sharpness of the highlights (phong). Default: from lighting.roughness.

• Type: number ≥ 0
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.specular color

Color of the highlights (phong). Default: lighting.specular gray.

• Type: color
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.emissive color

Color the surface emits regardless of the lights. Default black.

• Type: color
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.emissiveintensity number

Strength of emissive. Default 1.

• Type: number ≥ 0
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.reflectivity number

How much the environment is reflected (basic, lambert, phong, physical).

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.envmapintensity number

Strength of the environment's light (standard, physical). Default 1.

• Type: number ≥ 0
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.clearcoat number

A clear lacquer layer (physical). Default 0.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.clearcoatroughness number

Roughness of the clear coat (physical). Default 0.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.transmission number

Transmission, for glass-like surfaces (physical). Default 0.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.ior number

Index of refraction (physical). Default 1.5.

• Type: number from 1 to 2.333
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.thickness number

Thickness of transmissive volumes, scene units (physical).

• Type: number ≥ 0
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.sheen number

Velvet-like sheen (physical). Default 0.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.sheencolor color

Color of the sheen (physical).

• Type: color
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.sheenroughness number

Roughness of the sheen (physical). Default 1.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.iridescence number

Thin-film iridescence (physical). Default 0.

• Type: number from 0 to 1
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.steps integer

Number of shading bands (toon).

• Type: integer from 2 to 16
• Default: 3
• Array OK: no
• Edit type: calc
• Animatable: no

material.matcap string

URL of a matcap image (matcap): the surface takes its colors from it by normal direction.

• Type: string
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

material.castshadow boolean

Cast shadows from the lights of scene.lighting with castshadow (onto three.js material types and the ground plane).

• Type: boolean
• Default: false
• Array OK: no
• Edit type: calc
• Animatable: no

material.receiveshadow boolean

Receive shadows (three.js material types only).

• Type: boolean
• Default: false
• Array OK: no
• Edit type: calc
• Animatable: no