Advanced Chart Options

These options refine specialized chart behavior after you have selected a suitable chart type. Start with appearance and formatting for ordinary titles, colors and labels.

Apply only the options documented for your chart family. Switching types can clear options that belong to the previous type; renderer capabilities define what is supported.

Shared axis and flow options

Pivot uses the shared axis contract, including signed scales, numeric ticks, grouped category labels, named X/Y assignments and measured gutters. Display → Axes authors named X definitions and their navigation/brush targets. Declared named Y axes appear as editable value forms. Horizontal bars expose primary value/category forms plus horizontal secondary/named forms; gallery transitions clear incompatible positions and unsupported assignments atomically. Direct API transitions remain strict.

Sankey layout/sort/color/label/highlight fields come from the shared schema. Supply runtime sankey callbacks or categoryAxis.groups callbacks to createPivotChartsRenderer; reattach callbacks on restore. Heatmap row/column navigation uses the same canonical IDs and export scope as standalone Charts.

All grouped/stacked/normalized bars and columns also use the shared named-X authoring controls. Their category axes accept path levels, ID-based label mappings, grouped rows, reversal and independent viewport/brush targets. Additional bar category axes use left/right positions; columns use top/bottom. See bar/column category assignments.

Scatter, bubble and quadrant charts also accept axes.ySecondary, axes.yAxes[id] and seriesOverrides[boundYId].yAxis. The Pivot inspector limits assignment controls to bound Y measures. Scale/domain/reversal/ticks, error bars, value references, semantic notes and regression overlays follow that Y axis. Y navigation and synchronization remain primary-only; named/secondary hover shares X only. See all relationship axis options and limits.

Relationship groups also support axes.xAxes[id], seriesOverrides[boundYId].xAxis, viewport.xAxes[id], navigation.xAxis and rangeSelection.xAxis. The bound Y measure owns both assignments; bindings.x supplies numeric X values. Named X forms default to linear and omit category mapping controls. Named X scales, errors, annotations, brushes, navigator, synchronization and async full-domain metadata use that projection. See the full relationship X contract.

Candlestick and OHLC charts expose the shared primary price-axis form: axes.y supports linear/log/symlog/sqrt, bounds, reversal, vertical placement, title/unit/colors, numeric ticks and tick formatting. Price marks and annotations use the same clipped projection, and styled labels use measured gutters. See all financial price options and limits. Volume-price uses fixed price/volume controls described below; additional financial axis collections remain unsupported.

volumePrice shares category/time/numeric X navigation across aligned panes. axes.y configures prices and axes.ySecondary configures volume, including independent transforms, bounds, reversal, placement, units, formatting and ticks. Fixed roles preserve canonical data and reject swaps. Pivot exposes both forms. Notes/references/drawings use their pane’s scale; full-source/synchronized Y metadata remains price-only. See all volume-price options and limits.

Bound range columns/bars/areas, confidence bands and error intervals also support primary/secondary/named value axes and named X projections. The bound high measure owns each range group; low and actual fields follow it. Pivot exposes assignment controls on high measures. Scales, bounds, reversal, formatting, ticks, measured labels, clipping, annotations, navigator and brushes use the shared projections. See all range-axis options and limits.

Box plots, violins and statistical intervals also expose primary axes.y, secondary axes.ySecondary and named axes.yAxes numeric controls. Actual distributions own box/violin projections, and bound matrix observations own statistical intervals. Clipping, measured labels and annotations share those projections. Horizontal boxes retain physical value/category forms in Pivot. See all statistical-axis options and limits.

Statistical charts also support category windows, reversal/grouped labels, navigator/brush controls and primary-domain/category synchronization. Box/violin overviews and shared hover use displayed medians; canonical CSV cells remain unchanged. See statistical navigation options and boundaries.

Statistical primary X also supports time and all four numeric scales, including horizontal boxes. Raw key spacing, continuous brushes, annotations, navigator, source snapshots and remote detail/overview requests share that projection. See all statistical continuous-X options and physical-axis roles.

Histograms also expose primary aggregate-Y controls and optional numeric bin-boundary X scales. X comes from bound sample values; Y configures counts, sums or means. Bounds clip bins without rebucketing, and canonical CSV/observation identities remain intact. See all histogram-axis options and boundaries.

Histograms support local raw-sample X windows, zoom/pan, a bin-metric navigator, independent numeric brushes and compatible domain/window synchronization. Bins remain stable while the window clips their rectangles. See all histogram navigation options and boundaries. Histograms also support shared/crosshair/peer bin readouts and typed formatter metadata. Remote histogram loading uses complete-bin source summaries; typed metadata keeps global metrics separate from loaded raw rows.

Histogram Data views provide native Samples rows with numeric bin membership columns and a separate complete Bins inspection table. See all shared snapshot fields, scopes and localization.

Path sampling

Display → Appearance → Path sampling controls the shared Charts chartOptions.sampling setting for line/area and combination charts. Choices are Automatic, None, M4, Minimum / maximum, and Largest triangle (LTTB); resetting appearance returns to automatic. The exported PivotChartSampling type names these values. Models retain the choice, including server rendering. Read path sampling for supported types, stack alignment, raw-data guarantees, marker handling, and budgets.

Step endpoints

Display → Axes → [series] Step endpoints offers Automatic, Expanded bands, and Strict points for line/area layers. It writes seriesOverrides[id].strictStepCurve (false by default). Expansion applies to stepped categorical combination bands; native point and continuous X layouts retain exact geometry. The flag persists in models and SVG/SSR. Switching to a column/scatter/range layer or resetting appearance clears it. Read the step endpoint policy for gaps, reversal, sampled paths, and source identity.

Category placement

Display → Axes → [axis] Category placement writes axes.x.categoryPlacement or axes.xAxes[id].categoryPlacement independently. Choose Automatic, Point positions, or Centered bands on supported line/area and combination categorical axes. Native defaults stay points; combinations default to bands. Scale/gallery transitions clear incompatible settings while preserving sibling axes and compatible category-ID ranges. The PivotChartCategoryPlacement type names 'point' | 'band'. Read category placement for step expansion, column margins, grouped labels, navigator behavior and saved models.

Transient point highlights

Chart appearance → Disable point highlights writes chartOptions.disableLineItemHighlight. Axes → [series] Point highlights writes seriesOverrides[id].disableHighlight using Automatic/Enabled/Disabled. Both booleans default to false and share the standalone Charts implementation. They suppress the transient glyph while retaining source inspection and regular markers. See transient highlights for saved endpoint substitution, tooltips, keyboard traversal and clean export snapshots.

Statistical value-axis collections

boxPlot, violin and rangeInterval share axes.y, axes.ySecondary, named axes.yAxes and seriesOverrides[id].yAxis in Charts and Pivot. Numeric scale, bounds, reversal, units, ticks and formatting apply independently to each assigned group. Named IDs must be declared; secondary can be implicit. Box/violin domains use genuine distribution samples/summaries; violin supports multiple selected distributions, series color and visibility, while keeping its single-series category palette by default. Statistical intervals accept two or more measures without a three-measure cap and aggregate only within each assigned value-axis group. A singleton group preserves source activation; aggregates remain read-only inspection targets.

Vertical extra axes use left/right/none; horizontal box extra axes use top/bottom/none. Horizontal boxes retain their primary physical aliases (axes.x for value appearance, numeric settings in axes.y). Pivot reconciles extra-axis positions on orientation/type changes. Invalid direct updates are atomic. References, shapes, semantic notes, model persistence and SVG export use the assigned projection. Primary runtime Y hints do not fix secondary/named scales: author their bounds as needed. Named statistical X collections are described below.

Named statistical X axes

Box plots, violins and statistical intervals accept named axes.xAxes and per-series seriesOverrides[id].xAxis, plus primary/named data and level X mappings. Each X frame has its own category/time/numeric scale and viewport.xAxes[id]; navigation.xAxis and rangeSelection.xAxis select interaction targets. Statistical intervals partition observations by the X/Y assignment pair, while each Y domain includes its full assigned source statistics across X frames. Named X decorations use top/bottom/none vertically, left/right/none for horizontal boxes. Pivot shares the controls and reconciles positions on orientation changes. References/shapes/notes, save/SSR, activation and canonical data use the assigned projections. See the axes guide for fields, defaults and limits.

Financial numeric X

Candlestick, OHLC and volume-price charts accept primary axes.x.scale: 'linear' | 'log' | 'symlog' | 'sqrt' plus data/level X mappings, numeric bounds, reversal, units, tick formatting/policy and physical styles/placement. Both volume-price panes share raw X coordinates and navigation; glyph widths follow the nearest distinct visible numeric gap. Source activation, annotations, model/SSR and canonical CSV retain their existing contracts. Pivot exposes primary mapping/numeric controls, with named X on all financial collections and named Y on candlestick/OHLC. See the axes guide for defaults, field limits and remaining collection/pane capabilities.

Candlestick/OHLC collections

Candlestick and OHLC accept parallel open/high/low/close binding arrays. Close fields uniquely own groups and their seriesOverrides[id].xAxis/yAxis assignments; open/high/low helpers can broadcast and inherit their owners. Use axes.xAxes, axes.ySecondary and axes.yAxes for independent scale/style/window controls. Groups keep canonical source indexes, stable slots and independent value domains; missing rows omit only the incomplete group. CSV windows include every owned OHLC field, and primary runtime Y hints exclude secondary/named price groups. Pivot preserves explicit grouped bindings and exposes axis selectors on close owners. See the axes guide for channel rules, limits, annotations and source contracts. Volume-price paired collections retain one shared price pane and one shared volume pane, as described below.

Paired volume-price collections

volumePrice supports parallel OHLC/volume binding arrays, distinct paired close/volume owners and named X axes. Each close owns X for its prices and volume; Y remains primary for prices and secondary for all volumes. Both panes share aligned group slots, windows and raw source identity. Missing volume preserves complete prices; incomplete OHLC observations omit both sides of that pair. chartOptions.volumePaneRatio accepts 0.1–0.8 of post-gap height; unset/reset retains automatic 24% sizing and its small-pane policy. Pivot exposes close-owner X selectors, fixed Y forms and the ratio control. See the axes guide for pairing, mappings, helper transitions, hover, annotations, exports, source/SSR and remaining additional-pane/Y limits.

Source keyboard inspection

Pivot uses the shared Charts source traversal for native line/area charts and combination line/area layers. Hidden or sampled-out glyphs remain keyboard reachable with raw source tooltips and activation; derived/synthetic values stay inspection-only. The temporary focus ring is independent of visual-highlight suppression and excluded from export snapshots. No Pivot-specific option is required. See keys, eligibility, order and focus restoration.

Pie slice geometry

Pie, donut and semi-donut expose saved outerRadius, paddingAngle, cornerRadius, arcLabelRadius and arcLabelMinAngle under Display → Appearance. The shared renderer preserves adaptive ring placement when label radius is omitted; the editor preset is 0.7. Fields persist through models and exports. See units, defaults, ranges and limits.

Stack baselines

Display → Appearance → Stack baseline selects diverging, none or expand. The per-series selector under Axes and scales overrides its actual stack partition. Automatic removes the override; conflicting member policies reject. See default behavior, signed values and normalization precedence.

Native line and area groups

Native paths expose a per-series stack group field under Axes and scales, plus group order and baseline policies. Multiple groups and independent raw paths use the same Charts engine; no composition adapter changes their public chart type. See defaults, normalized groups, baseline conflicts and sampling.

Compact sparklines

Enable Display → Chart appearance → Sparkline on a native line/area or grouped-column chart. It uses the shared persisted chartOptions.sparkline mode, keeps raw source identity and keyboard/tooltip inspection, and hides chart furniture while fitting the host. Turn it off to restore authored headings, axes, legend and navigation. See sparklines for supported types, defaults and sizing/export rules.

Histogram collections

Explicit histogram sample bindings can use shared or independent axes and per-sample paint/visibility. In Data, Sample series switches between each distribution’s raw records and complete bins. Existing axis controls target the samples, while weighted helper measures stay out of the legend. See histogram collections for bindings, all options and complete remote-source contracts.

Pie highlighting and fading

Shared pieHighlight and pieFade appearance controls select item/ring scope and peer fading. Saved highlightedArc/fadedArc styles and highlightedPieItem controlled identity configure geometry and paint. See all fields, units, defaults, callbacks and snapshot behavior.

Radar metric axes

Radar line and area share independent numeric metric domains/scales, reversible projection, authored grid bands and value labels through axes.radar and radar appearance options. See radar axis contracts and Pivot editing.

Polar columns and radial bars share saved polar geometry controls in Display → Appearance, including rotation, partial sweeps, direction, radius ratios and category/series gaps.

The six polar/radial-bar types share polar numeric value axes in Display → Axes and scales, including scale/bounds, reversal, numeric ticks, units and independent value/category/grid visibility.

Next steps

See the data/channel reference and API.