Charts · Gutenberg
Gauge Chart block for WordPress
SVG semicircular gauge / speedometer that animates on scroll with configurable color zones.
Get Blockenberg
Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.
What it actually does
SVG semicircular gauge / speedometer that animates on scroll with configurable color zones.
Inspector panels on this block: Value, Color Zones, Zone, Visual, Animation. Those titles come from index.js, not from a shared template.
Where to find it
Gutenberg inserter → Charts → search “Gauge Chart” (block name `blockenberg/gauge-chart` in block.json). Style it in the sidebar after insert.
How to use Gauge Chart block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Gauge Chart”, insert it. Category: Charts.
- Configure inspector controls that exist on this block. Open Value. Set “Value”, “Label”, “Unit”, “Min Value”.
- Check the published page. The view script reads HTML data attributes: data-cx, data-cy, data-duration, data-max, data-min, data-perimeter, data-r, data-show-needle. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Value | Numeric range control in the inspector. block.json default: 72. Saved as `value`. |
| Label | Text field in the inspector. block.json default: Performance Score. Saved as `label`. |
| Unit | Text field in the inspector. block.json default: %. Saved as `unit`. |
| Min Value | Numeric range control in the inspector. block.json default: 0. Saved as `minValue`. |
| Max Value | Numeric range control in the inspector. block.json default: 100. Saved as `maxValue`. |
| From (%) | Numeric range control in the inspector. Range 0–99. |
| To (%) | Numeric range control in the inspector. Range 1–100. |
| Size (px) | Numeric range control in the inspector. Range 100–600. block.json default: 260. Saved as `size`. |
| Stroke Width | Numeric range control in the inspector. Range 4–50. block.json default: 18. Saved as `strokeWidth`. |
| Show Needle | On/off toggle in the inspector. Off by default. Saved as `showNeedle`. |
| Show Value | On/off toggle in the inspector. On by default. Saved as `showValue`. |
| Show Label | On/off toggle in the inspector. On by default. Saved as `showLabel`. |
| Show Tick Marks | On/off toggle in the inspector. On by default. Saved as `showTicks`. |
| Tick Count | Numeric range control in the inspector. Range 2–20. block.json default: 10. Saved as `tickCount`. |
| Animate Duration (ms) | Numeric range control in the inspector. Range 200–5000. block.json default: 1200. Saved as `animateDuration`. |
| Track Color | Color control in the inspector. block.json default: #e5e7eb. Saved as `trackColor`. |
| Value Color | Color control in the inspector. block.json default: #111827. Saved as `valueColor`. |
| Label Color | Color control in the inspector. block.json default: #6b7280. Saved as `labelColor`. |
| Needle Color | Color control in the inspector. block.json default: #374151. Saved as `needleColor`. |
| Colors — Background | Color control in the inspector. Saved as `bgColor`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-cx, data-cy, data-duration, data-max, data-min, data-perimeter, data-r, data-show-needle.
- An IntersectionObserver starts work when the block enters the viewport.
When this is the right block
- SVG semicircular gauge / speedometer that animates on scroll with configurable color zones — that is the job of Gauge Chart, not a generic content block.
- Use it when you need the editor control labeled “Value”, which exists on this block’s inspector.
- Inserter grouping: reports, dashboards, and data-heavy pages.
Notes from the implementation
viewScript: this folder’s frontend.js is enqueued on the front end for this block.
FAQ
How do I add the Gauge Chart block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Gauge Chart”. It sits under Charts. After insert, open Value and set “Value”, “Label”, “Unit”, “Min Value”.
What makes Gauge Chart different from other Blockenberg blocks?
SVG semicircular gauge / speedometer that animates on scroll with configurable color zones. Inspector labels on this block include “Value”, “Label”, “Unit”, “Min Value”.
Is the Gauge Chart Gutenberg block free?
Yes. Gauge Chart ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Gauge Chart to match my theme?
Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Value, Color Zones, Zone, Visual).
Related charts blocks
Area Chart
Smooth filled area chart with multiple datasets, gradient fills, and animation using Chart.js (CDN). Great for showing trends over time.
Bar Chart
Vertical or horizontal bar chart with multiple datasets using Chart.js (CDN). Supports stacked, border radius, and custom colors.
Box Plot
Box-and-whisker statistical chart showing min, Q1, median, Q3, max, mean, and outliers for multiple data series.
Bubble Chart
Interactive bubble chart powered by Chart.js.
Bullet Chart
Stephen Few's bullet chart — shows actual performance against a target, with background bands for Poor / Satisfactory / Good ranges.
Bump Chart
Ranking chart that shows how positions change over time — each series is a curved line with rank labels at each column.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Gauge Chart from the Gutenberg inserter.