Charts · Gutenberg
Waffle Chart block for WordPress
Proportional 10×10 grid where each cell represents 1%. An intuitive and visually engaging alternative to pie charts for showing progress and part-to-whole relationships.
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
Proportional 10×10 grid where each cell represents 1%. An intuitive and visually engaging alternative to pie charts for showing progress and part-to-whole relationships.
Inspector panels on this block: Chart Settings, Grid Appearance, Segments. Those titles come from index.js, not from a shared template.
Waffle Chart has no render.php and no frontend.js. The saved Gutenberg HTML is what visitors see, plus Blockenberg layout/typography CSS.
Where to find it
Gutenberg inserter → Charts → search “Waffle Chart” (block name `blockenberg/waffle-chart` in block.json). Style it in the sidebar after insert.
How to use Waffle Chart block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Waffle Chart”, insert it. Category: Charts.
- Configure inspector controls that exist on this block. Open Chart Settings. Set “Chart Settings — Title”, “Show Title”, “Show Legend”, “Show as Percent”.
- Publish. Save the page. Output is the saved block HTML; typography/colors follow Blockenberg shared panels.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Chart Settings — Title | Text field in the inspector. block.json default: Budget Allocation. Saved as `title`. |
| Show Title | On/off toggle in the inspector. On by default. Saved as `showTitle`. |
| Show Legend | On/off toggle in the inspector. On by default. Saved as `showLegend`. |
| Show as Percent | On/off toggle in the inspector. On by default. Saved as `showPercent`. |
| Show Raw Values | On/off toggle in the inspector. Off by default. Saved as `showValues`. |
| Cell Gap (px) | Numeric range control in the inspector. Range 0–16. block.json default: 3. Saved as `cellGap`. |
| Cell Radius (px) | Numeric range control in the inspector. Range 0–20. block.json default: 4. Saved as `cellRadius`. |
| Cell Size (px) | Numeric range control in the inspector. Range 14–60. block.json default: 28. Saved as `cellSize`. |
| Colors — Background | Color control in the inspector. block.json default: #ffffff. Saved as `bgColor`. |
| Empty Cell | Color control in the inspector. block.json default: #f3f4f6. Saved as `emptyColor`. |
| Title Color | Color control in the inspector. block.json default: #111827. Saved as `titleColor`. |
| Text Color | Color control in the inspector. block.json default: #374151. Saved as `textColor`. |
| Label | Text field in the inspector. |
| Value | Numeric range control in the inspector. Range 0–10000. |
When this is the right block
- Proportional 10×10 grid where each cell represents 1%. An intuitive and visually engaging alternative to pie charts for showing progress and part-to-whole relationships — that is the job of Waffle Chart, not a generic content block.
- Use it when you need the editor control labeled “Chart Settings — Title”, which exists on this block’s inspector.
- It matches pages about waffle, chart, grid.
- Inserter grouping: reports, dashboards, and data-heavy pages.
Notes from the implementation
Static block: markup is saved in post content; no PHP render callback in this folder.
FAQ
How do I add the Waffle Chart block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Waffle Chart”. It sits under Charts. After insert, open Chart Settings and set “Chart Settings — Title”, “Show Title”, “Show Legend”, “Show as Percent”.
What makes Waffle Chart different from other Blockenberg blocks?
Proportional 10×10 grid where each cell represents 1%. An intuitive and visually engaging alternative to pie charts for showing progress and part-to-whole relationships. Inspector labels on this block include “Chart Settings — Title”, “Show Title”, “Show Legend”, “Show as Percent”.
Is the Waffle Chart Gutenberg block free?
Yes. Waffle Chart ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Waffle 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: Chart Settings, Grid Appearance, Segments).
Related charts blocks
Heatmap Calendar
GitHub-style activity heatmap calendar showing intensity by day across a full year. 53 × 7 grid of colour-coded squares with month labels, day-of-week labels, and a configurable colour scale.
Treemap Chart
Hierarchical data visualized as proportional nested rectangles. Great for market share, budget breakdowns, and category comparisons.
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.
Bubble Chart
Interactive bubble chart powered by Chart.js.
Data Table
Interactive data table with sorting, search, pagination and export.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Waffle Chart from the Gutenberg inserter.