box attributes

Box plots: the quartiles, median, whiskers (fences at 1.5 IQR) and outliers of samples at each position, or of precomputed statistics, with notches, means and jittered points; drawn as batched GPU fills, lines and markers.

• Categories: cartesian, showLegend, box-violin, boxLayout
• Plotly equivalent: box
• Guide: box chart page
• Used in examples: box/basic, box/dates, box/grouped, box/horizontal, box/interaction, box/notched, box/points, box/precomputed, demos/dallas-weather/decade-box, demos/dallas-weather/wind-month-box, demos/index-funds/returns-box, demos/science-basics/density-box, demos/science-basics/pendulum-box, demos/tqqq-soxl/returns-box, strip/with-box

Generated from the attribute schema (95 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
• y
• x0
• y0
• dx
• dy
• q1
• median
• q3
• lowerfence
• upperfence
• mean
• sd
• notchspan
• notched
• notchwidth
• boxpoints
• jitter
• pointpos
• sdmultiple
• sizemode
• boxmean
• orientation
• width
• offsetgroup
• alignmentgroup
• quartilemethod
• marker

  • outliercolor
  • symbol
  • opacity
  • angle
  • size
  • color
  • line

    • color
    • width
    • outliercolor
    • outlierwidth
• line

  • color
  • width
• fillcolor
• whiskerwidth
• showwhiskers
• selected

  • marker

    • color
    • opacity
• unselected

  • marker

    • color
    • opacity
• text
• zorder
• hoveron

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 samples: the values of horizontal boxes when y is not given, else the position of each sample (one box per distinct x) for vertical boxes. With precomputed statistics (q1, median, q3): the position of each box, or one sample array per box on the value axis.

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

y data_array

y samples: the values of horizontal boxes when x is not given, else the position of each sample (one box per distinct y) for vertical boxes. With precomputed statistics (q1, median, q3): the position of each box, or one sample array per box on the value axis.

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

x0 any

Position of the box when x is not given. Default: the trace name on category axes (and numeric or date names on linear, log and date axes), else the box's index among the box traces.

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

y0 any

Position of the box when y is not given. Default: the trace name on category axes (and numeric or date names on linear, log and date axes), else the box's index among the box traces.

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

dx number

Step between the positions of precomputed boxes when x is not given: box i is at x0 + i·dx. Default 1.

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

dy number

Step between the positions of precomputed horizontal boxes when y is not given. Default 1.

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

q1 data_array

Precomputed first quartiles, one per box. With median and q3, switches the trace to precomputed statistics.

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

median data_array

Precomputed medians, one per box.

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

q3 data_array

Precomputed third quartiles, one per box.

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

lowerfence data_array

Precomputed lower whisker ends, one per box. Default: the lowest sample within 1.5 IQR of q1 when samples are given, else q1.

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

upperfence data_array

Precomputed upper whisker ends, one per box. Default: the highest sample within 1.5 IQR of q3 when samples are given, else q3.

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

mean data_array

Precomputed means, one per box (turns boxmean on by default). Default: the sample mean, else (q1 + q3) / 2.

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

sd data_array

Precomputed standard deviations, one per box (with mean, makes boxmean: 'sd' the default). Default: the sample standard deviation, else q3 − q1.

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

notchspan data_array

Precomputed notch half-heights, one per box (turns notched on by default). Default: 1.57 · IQR / √n.

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

notched boolean

Draw notches at the median's 95% confidence interval (median ± 1.57 · IQR / √n): boxes whose notches don't overlap have different medians with roughly 95% confidence. Default: true when notchwidth (or notchspan) is set.

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

notchwidth number

How far notches cut into the box, as a fraction of its width (0–0.5).

• Type: number from 0 to 0.5
• Default: 0.25
• Array OK: no
• Edit type: calc
• Animatable: no

boxpoints enumerated

Which samples are drawn as points: 'all', only those beyond the whiskers ('outliers', the default), those plus a highlight of the ones between the whiskers and 3 IQR from the quartiles ('suspectedoutliers', styled by marker.outliercolor and marker.line.outlier*), or none (false, the whiskers then reach the extreme samples). Default: 'suspectedoutliers' when an outlier color is set, 'all' with precomputed statistics, else 'outliers'.

• Type: enumerated
• Values: "all" | "outliers" | "suspectedoutliers" | false
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

jitter number

Random spread of the points across the position axis, as a fraction of the box width (0: all on one line). Denser stretches spread more. Default: 0.3 with boxpoints: 'all', else 0. The spread is repeatable (Plotly's seeded generator).

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

pointpos number

Where the points sit relative to the box, in box half-widths: 0 on its center line, 1 on its right (or top) edge, −2 one box width to the left (or below). Default: −1.5 with boxpoints: 'all', else 0.

• Type: number from -2 to 2
• Default: none
• Array OK: no
• Edit type: calc
• Animatable: no

sdmultiple number

How many standard deviations the sizemode: 'sd' box and the boxmean: 'sd' diamond span on each side of the mean.

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

sizemode enumerated

'quartiles': the box spans q1–q3 with a line at the median; 'sd': it spans mean ± sdmultiple standard deviations with a line at the mean (no whiskers by default).

• Type: enumerated
• Values: "quartiles" | "sd"
• Default: "quartiles"
• Array OK: no
• Edit type: calc
• Animatable: no

boxmean enumerated

Draw the mean as a dashed line (true), plus a dashed diamond spanning ± sdmultiple standard deviations ('sd'). Default: on with precomputed mean (and 'sd' with sd).

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

orientation enumerated

'v': vertical boxes at x positions over y values; 'h': horizontal ones at y positions. Default: 'v' when y is given, else 'h'.

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

width number

Box width in position-axis units (category slots, or ms on date axes). 0 (default): computed from the spacing of the positions and layout.boxgap, boxgroupgap and boxmode.

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

offsetgroup string

With layout.boxmode: 'group', traces with the same offset group share one slot at each position; different offset groups sit side by side.

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

alignmentgroup string

Traces on the same position axis with the same alignment group split each position between their offset groups; different alignment groups lay out independently.

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

quartilemethod enumerated

How quartiles are computed from samples: linear interpolates over the whole sample (Plotly's method, the one most tools call type 5); for odd counts, exclusive takes the medians of the lower and upper halves without the median, inclusive with it. Even counts use linear in every method.

• Type: enumerated
• Values: "linear" | "exclusive" | "inclusive"
• Default: "linear"
• Array OK: no
• Edit type: calc
• Animatable: no

marker

Style of the sample points.

• Type: object
• Edit type: calc

marker.outliercolor color

Fill of suspected outliers (between the whiskers and 3 IQR from the quartiles) with 'suspectedoutliers'. Setting it makes that mode the default.

• Type: color
• Default: "rgba(0, 0, 0, 0)"
• Array OK: no
• Edit type: style
• Animatable: no

marker.symbol enumerated

Point symbol: a name ('diamond-open'), a Plotly numeric code, a registered custom symbol or a 'text:…' glyph.

• 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: no
• Edit type: style
• Animatable: no

marker.opacity number

Point opacity (multiplied by the trace opacity).

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

marker.angle angle

Point rotation in degrees, clockwise.

• Type: angle (degrees)
• Default: 0
• Array OK: no
• Edit type: style
• Animatable: no

marker.size number

Point diameter in CSS px.

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

marker.color color

Point fill color. Default: line.color.

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

marker.line

Point outlines.

• Type: object
• Edit type: style

marker.line.color color

Point outline color.

• Type: color
• Default: "#444"
• Array OK: no
• Edit type: style
• Animatable: no

marker.line.width number

Point outline width in CSS px.

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

marker.line.outliercolor color

Outline color of suspected outliers with 'suspectedoutliers'. Default: marker.color. Setting it makes that mode the default.

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

marker.line.outlierwidth number

Outline width (px) of suspected outliers with 'suspectedoutliers'.

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

line

Outline of the box.

• Type: object
• Edit type: style

line.color color

Outline color of the box, its median and whiskers. Default: marker.color, else the colorway.

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

line.width number

Outline width in CSS px.

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

fillcolor color

Fill color of the box. Default: line.color at half opacity.

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

whiskerwidth number

Width of the whisker caps as a fraction of the box width (0: no caps).

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

showwhiskers boolean

Draw the whiskers. Default: true, except with sizemode: 'sd'.

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

selected

Style of selected points while a selection is active.

• Type: object
• Edit type: style

selected.marker

Marker style of selected points.

• Type: object
• Edit type: style

selected.marker.color color

Color of selected points.

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

selected.marker.opacity number

Opacity of selected points.

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

unselected

Style of unselected points while a selection is active.

• Type: object
• Edit type: style

unselected.marker

Marker style of unselected points.

• Type: object
• Edit type: style

unselected.marker.color color

Color of unselected points.

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

unselected.marker.opacity number

Opacity of unselected points. Default: 0.2 × the marker opacity.

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

text string

Text per sample, shown in the hover label of its point.

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

zorder integer

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

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

hoveron flaglist

What shows hover labels: the boxes (one label per statistic, as Plotly), the points, or both (a point under the pointer wins).

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