WPGO documentationChartQuill

Generated product reference

Every ChartQuill control, in one place.

Use this technical reference when you know the block or shortcode you need. It is generated from the same public contracts used by ChartQuill 1.2.0.

Current documentation Version 1.2.0Released 15 August 2026See what changed
Blocks2

Editor controls and saved block attributes.

Plugin settings2

Released global option contract.

Block editor

Block settings

The saved attribute name is shown below each human label. Pro rows appear only when the Pro edition provides that control.

Block · 78 settings

ChartQuill Chart

Free

Store the dataset, chart recipe, mappings, written context, formatting, presentation, analysis, colour, and annotations for one chart.

ChartQuill Chart settings
SettingEditionType and defaultPurpose and accepted values
Chart tagchartTagFreestringDefault: Empty

Readable post-scoped reference used to connect Chart Data Table blocks; ChartQuill keeps it unique.

  • A readable unique tag within the post
  • Empty until ChartQuill assigns a tag
Chart familychartDocument.recipe.idFreestringDefault: bar

Select the broad chart family before choosing a compatible style.

  • bar
  • line
  • scatter
  • histogram
  • heatmap
  • pie
Chart stylechartDocument.recipe.optionsFreeobjectDefault: {"orientation":"vertical","mode":"single"}

Select one of the released style recipes. Pro recipes remain saved when entitlement is unavailable.

  • Free: vertical bars, horizontal bars, grouped vertical bars, grouped horizontal bars, dot plot, lollipop, line, scatter, histogram, heatmap, pie
  • Pro: stacked vertical and horizontal bars, 100% stacked vertical and horizontal bars, bullet, diverging Likert, waterfall, area, scatter trend, bubble, box plot, donut
Data columnschartDocument.data.columnsFreearrayDefault: [{"id":"category","label":"Category","type":"string"},{"id":"value","label":"Value","type":"number"}]

Define each dataset column with a stable ID, visible label, and string, number, or date type.

  • At least two columns
  • Column types: string, number, date
Data rowschartDocument.data.rowsFreearrayDefault: [{"category":"Research","value":42},{"category":"Design","value":68},{"category":"Development","value":91}]

Store rows entered directly, pasted from a spreadsheet, or imported from a local CSV/TSV file after review.

  • Rows whose keys match the saved column IDs
Category or horizontal-axis columnchartDocument.encoding.xFreestringDefault: category

Map the category, sequence, or horizontal measure required by the selected chart.

  • A compatible saved column ID
Value or vertical-axis columnchartDocument.encoding.yFreestringDefault: value

Map the primary numeric measure, or the second category dimension for a heatmap.

  • A compatible saved column ID
Series columnchartDocument.encoding.seriesFreestringDefault: Empty

Optionally split supported charts into multiple named series; grouped and stacked charts require it.

  • A compatible saved column ID
  • Empty for a single series
Heatmap colour valuechartDocument.encoding.colorFreestringDefault: Empty

Map the numeric value represented by heatmap colour intensity.

  • A numeric saved column ID
  • Empty outside the heatmap workflow
Bubble size columnchartDocument.encoding.sizeProstringDefault: Empty

Map the non-negative numeric measure represented by bubble size.

  • A numeric saved column ID
  • Empty outside the Pro bubble workflow
Bubble label columnchartDocument.recipe.options.bubbleLabelColumnProstringDefault: Empty

Choose the field used to identify each bubble in hover details and optional direct labels.

  • A saved data column ID
  • Empty to use the bubble-size field label
Show bubble-size legendchartDocument.recipe.options.showBubbleSizeLegendProbooleanDefault: true

Show or hide the representative size guide without changing the separate series legend.

  • On
  • Off
Show values on hoverchartDocument.recipe.options.showBubbleHoverValuesProbooleanDefault: true

Show exact label, series, axis, and bubble-size values when a reader hovers over a bubble.

  • On
  • Off
Visible bubble labelschartDocument.recipe.options.bubbleLabelContentProstringDefault: none

Choose which information is printed directly beside or inside supported bubbles.

  • none
  • label
  • size
  • label-and-size
Bubble label positionchartDocument.recipe.options.bubbleLabelPositionProstringDefault: center

Position direct labels in the centre of a bubble or outside it.

  • center
  • left
  • right
  • above
  • below
Bubble label colourchartDocument.recipe.options.bubbleLabelColorProstringDefault: auto

Use automatic contrast or a chosen six-digit hexadecimal colour for direct bubble labels.

  • auto
  • A six-digit hexadecimal colour
Bubble label sizechartDocument.recipe.options.bubbleLabelFontSizePronumberDefault: 10

Set the direct bubble-label font size in pixels.

  • A whole number from 8 to 24
Minimum bubble value to labelchartDocument.recipe.options.bubbleLabelMinSizePronumberDefault: 0

Label only bubbles whose mapped size value meets this threshold.

  • Zero or a positive number
Bubble label horizontal offsetchartDocument.recipe.options.bubbleLabelDxPronumberDefault: 0

Fine-tune the direct bubble-label position horizontally in pixels.

  • A number from -80 to 80
Bubble label vertical offsetchartDocument.recipe.options.bubbleLabelDyPronumberDefault: 0

Fine-tune the direct bubble-label position vertically in pixels.

  • A number from -80 to 80
TitlechartDocument.content.titleFreestringDefault: Project activity

Name the subject and comparison displayed with the chart.

  • Plain text
Accessible summarychartDocument.content.summaryFreestringDefault: Development has the highest activity in this sample dataset.

State the main takeaway in text rather than repeating every plotted value.

  • Plain text
SourcechartDocument.content.sourceFreestringDefault: Sample data

Identify the origin of the data and relevant period.

  • Plain text
  • Empty when no source line is required
UnitchartDocument.content.unitFreestringDefault: Empty

Label the measurement used by values and linked tables.

  • Plain text such as %, £, visits, or kg
  • Empty for unitless values
Value formatchartDocument.formatting.valueStyleFreestringDefault: number

Choose how numeric values are formatted in labels, summaries, and tables.

  • number
  • compact
  • currency
  • percent
Currency codechartDocument.formatting.currencyFreestringDefault: USD

Supply the ISO-style code used when Value format is Currency.

  • Exactly three letters, for example USD, GBP, or EUR
Decimal placeschartDocument.formatting.decimalPlacesFreestring or numberDefault: auto

Use automatic precision or a fixed number of decimal places.

  • auto
  • 0
  • 1
  • 2
  • 3
  • 4
Date formatchartDocument.formatting.dateStyleFreestringDefault: medium

Choose the display length used when the dataset contains a date column.

  • short
  • medium
  • long
Chart heightchartDocument.presentation.heightFreestringDefault: auto

Choose an automatic or preset chart height.

  • auto
  • compact
  • medium
  • tall
Legend positionchartDocument.presentation.legendPositionFreestringDefault: top

Position or hide the text legend when the chart has series or slices.

  • top
  • bottom
  • hidden
Horizontal-axis tickschartDocument.scales.x.tickDensityFreestringDefault: auto

Adjust the density of horizontal-axis tick labels.

  • auto
  • sparse
  • dense
Vertical-axis tickschartDocument.scales.y.tickDensityFreestringDefault: auto

Adjust the density of vertical-axis tick labels.

  • auto
  • sparse
  • dense
Category orderchartDocument.transforms.categoryOrderFreestringDefault: original

Order bar or pie categories without rewriting the source rows.

  • original
  • alphabetical
  • value-ascending
  • value-descending
Bar spacingchartDocument.presentation.barGapFreestringDefault: normal

Choose the spacing between supported bars.

  • compact
  • normal
  • wide
Bar cornerschartDocument.presentation.barRadiusFreestringDefault: none

Choose square, subtly rounded, or rounded bar corners.

  • none
  • subtle
  • rounded
Line shapechartDocument.presentation.lineCurveFreestringDefault: linear

Choose how points are connected in line charts.

  • linear
  • step
  • monotone-x
Line weightchartDocument.presentation.lineWidthFreestringDefault: regular

Choose a thin, regular, or bold stroke for line charts.

  • thin
  • regular
  • bold
Point sizechartDocument.presentation.pointSizeFreestringDefault: medium

Size points in line, scatter, dot, and lollipop charts.

  • small
  • medium
  • large
Show pointschartDocument.recipe.options.showPointsFreebooleanDefault: true

Show or hide point marks on a line chart.

  • On
  • Off
Chart colourchartDocument.appearance.colorFreestringDefault: Empty

Apply one accent colour when the chart does not use a series palette or heatmap scale.

  • A hexadecimal colour
  • Empty to inherit the block text colour
Show chart gridchartDocument.presentation.showGridFreebooleanDefault: true

Show or hide grid lines on supported Cartesian charts.

  • On
  • Off
Show valueschartDocument.presentation.showValuesFreebooleanDefault: false

Show or hide direct value labels on supported chart styles.

  • On
  • Off
Pie label formatchartDocument.presentation.pieLabelStyleFreestringDefault: percentage

Choose percentages or formatted values when pie slice labels are enabled.

  • percentage
  • value
Bullet target columnchartDocument.recipe.options.targetColumnProstringDefault: Empty

Map the target used by a bullet chart.

  • A numeric saved column ID
Bullet first rangechartDocument.recipe.options.range1ColumnProstringDefault: Empty

Map the first qualitative range used by a bullet chart.

  • A numeric saved column ID
Bullet second rangechartDocument.recipe.options.range2ColumnProstringDefault: Empty

Map the second qualitative range used by a bullet chart.

  • A numeric saved column ID
Bullet third rangechartDocument.recipe.options.range3ColumnProstringDefault: Empty

Map the third qualitative range used by a bullet chart.

  • A numeric saved column ID
Series calculationchartDocument.transforms.series.modeProstringDefault: none

Calculate a display series without modifying source data; this control is available for line charts.

  • none
  • rolling-average
  • cumulative
  • indexed
Rolling windowchartDocument.transforms.series.windowPronumberDefault: 3

Choose the number of points used by the rolling-average calculation.

  • A whole number from 2 to 12
Show top categorieschartDocument.transforms.categoryLimit.countPronumberDefault: Empty

Keep the highest-value categories and combine the remainder; supported by single bars, dot, lollipop, and pie.

  • 2 to 20
  • Empty to show every category
Combined category labelchartDocument.transforms.categoryLimit.otherLabelProstringDefault: Other

Name the combined remainder created by the Top-N calculation.

  • Plain text up to 40 characters
Show uncertainty bandchartDocument.transforms.uncertainty.enabledProbooleanDefault: false

Show an author-supplied lower and upper band on an untransformed line chart.

  • On
  • Off
Lower-bound columnchartDocument.transforms.uncertainty.lowerColumnProstringDefault: Empty

Map the numeric lower bound used by the uncertainty band.

  • A numeric saved column ID
Upper-bound columnchartDocument.transforms.uncertainty.upperColumnProstringDefault: Empty

Map the numeric upper bound used by the uncertainty band.

  • A numeric saved column ID
Histogram bin countchartDocument.transforms.histogram.thresholdsProstring or numberDefault: auto

Use automatic bins or choose the number of histogram bins.

  • auto
  • A whole number from 4 to 50
Histogram vertical measurechartDocument.transforms.histogram.normalizationProstringDefault: count

Plot observation counts or each bin's percentage of all observations.

  • count
  • percent
Cumulative distributionchartDocument.transforms.histogram.cumulativeProbooleanDefault: false

Accumulate histogram values from left to right.

  • On
  • Off
Show mean linechartDocument.transforms.histogram.showMeanProbooleanDefault: false

Add a line at the arithmetic mean.

  • On
  • Off
Show median linechartDocument.transforms.histogram.showMedianProbooleanDefault: false

Add a line at the median.

  • On
  • Off
Show confidence bandchartDocument.transforms.regression.showConfidenceProbooleanDefault: false

Display the 95 percent confidence interval around a scatter trend line.

  • On
  • Off
Heatmap colour schemechartDocument.scales.color.schemeProstringDefault: blues

Choose the sequential or diverging scale used by a heatmap.

  • blues
  • greens
  • oranges
  • purples
  • viridis
  • rdbu
Reverse heatmap scalechartDocument.scales.color.reverseProbooleanDefault: false

Reverse the selected heatmap colour scale.

  • On
  • Off
Diverging midpointchartDocument.scales.color.midpointPronumberDefault: Empty

Set an optional pivot for a diverging heatmap scale.

  • Any finite number
  • Empty for an automatic midpoint
Show heatmap cell valueschartDocument.transforms.heatmap.showCellValuesProbooleanDefault: false

Print each numeric value inside its heatmap cell.

  • On
  • Off
Horizontal scalechartDocument.scales.x.typeProstringDefault: auto

Choose the numeric transformation used by a compatible horizontal axis.

  • auto
  • linear
  • log
  • symlog
Horizontal minimumchartDocument.scales.x.minimumPronumberDefault: Empty

Set an optional explicit horizontal-axis minimum.

  • Any finite number
  • Empty for automatic
Horizontal maximumchartDocument.scales.x.maximumPronumberDefault: Empty

Set an optional explicit horizontal-axis maximum.

  • Any finite number
  • Empty for automatic
Vertical scalechartDocument.scales.y.typeProstringDefault: auto

Choose the numeric transformation used by a compatible vertical axis.

  • auto
  • linear
  • log
  • symlog
Vertical minimumchartDocument.scales.y.minimumPronumberDefault: Empty

Set an optional explicit vertical-axis minimum.

  • Any finite number
  • Empty for automatic
Vertical maximumchartDocument.scales.y.maximumPronumberDefault: Empty

Set an optional explicit vertical-axis maximum.

  • Any finite number
  • Empty for automatic
Reusable palettechartDocument.appearance.paletteProstringDefault: chartquill-default

Apply a built-in palette or the site-wide brand palette to series or slices.

  • chartquill-default
  • ocean
  • editorial
  • high-contrast
  • brand
Series and slice colourschartDocument.appearance.overridesProarrayDefault: Empty array

Override the palette colour for individual series or pie/donut slices.

  • Saved key and hexadecimal-colour pairs
Conditional colour ruleschartDocument.appearance.conditionalRulesProarrayDefault: Empty array

Apply up to four value-based colour rules.

  • greater-than
  • greater-than-or-equal
  • less-than
  • less-than-or-equal
  • between
  • positive
  • negative
Individual mark colourschartDocument.appearance.markOverridesProarrayDefault: Empty array

Override up to 32 individual marks after conditional rules are evaluated.

  • Saved mark key and hexadecimal-colour pairs
Reference lineschartDocument.annotations.referenceLinesProarrayDefault: Empty array

Add up to four labelled thresholds on supported numeric axes.

  • Axis x or y, numeric value, label, and hexadecimal colour
Point calloutschartDocument.annotations.calloutsProarrayDefault: Empty array

Attach up to six labelled callouts to plotted data points.

  • Saved point, label up to 120 characters, and hexadecimal colour
Shaded rangeschartDocument.annotations.rangesProarrayDefault: Empty array

Add up to four labelled ranges to supported axes.

  • Axis x or y, start, end, optional label, and hexadecimal colour
Direct series labelschartDocument.annotations.directLabelsProbooleanDefault: false

Label each series at its final plotted point on supported line and scatter charts.

  • On
  • Off

Block · 6 settings

Chart Data Table

Free

Publish a separately positioned semantic table that synchronizes with a tagged chart and retains its last saved snapshot.

Chart Data Table settings
SettingEditionType and defaultPurpose and accepted values
Source chart tagchartTagFreestringDefault: Empty

Connect the table to a ChartQuill chart in the same post.

  • A chart tag present in the post
  • A retained tag for a saved snapshot
Saved chart snapshotchartDocumentSnapshotFreeobjectDefault: Empty

Retain the last synchronized ChartDocument so the table keeps publishing if the source chart is removed.

  • A supported ChartDocument snapshot
CaptioncaptionFreestringDefault: Empty

Set the table caption; an empty value falls back to the source chart title or Chart data table.

  • Plain text
  • Empty for the generated fallback
Show captionpresentation.showCaptionFreebooleanDefault: true

Show the caption visually or keep it available only to screen readers.

  • On
  • Off
Densitypresentation.densityFreestringDefault: comfortable

Choose comfortable or compact cell spacing.

  • comfortable
  • compact
Table styleblockStyleFreestringDefault: minimal

Choose the native block style; Pro adds Editorial and Report.

  • Free: minimal, grid, stripes
  • Pro: editorial, report

WordPress options

Plugin settings

Global settings apply only where described; each row states its edition, default, and accepted values.

Plugin settings
SettingEditionType and defaultPurpose and accepted values
Default chart colourchartquill_settings.default_chart_colorFreestringDefault: Empty

Seed newly inserted charts with a six-digit hexadecimal colour; existing charts never change.

  • A six-digit hexadecimal colour
  • Empty to inherit the theme colour
Site brand palettechartquill_premium_settings.brand_paletteProarrayDefault: ["#0b57a4","#b43c16","#00876c","#8b4a9c","#9a6700","#0b7c9d"]

Store one reusable site palette assigned from left to right to chart series or slices.

  • 2 to 8 hexadecimal colours