Charts · Gutenberg
Waterfall Bar Chart block for WordPress
Bridge / waterfall chart showing cumulative running totals with positive and negative steps.
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
Bridge / waterfall chart showing cumulative running totals with positive and negative steps.
Inspector panels on this block: Chart Settings, Layout, Items. Those titles come from index.js, not from a shared template.
Waterfall Bar 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 “Waterfall Bar Chart” (block name `blockenberg/waterfall-bar` in block.json). Style it in the sidebar after insert.
How to use Waterfall Bar Chart block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Waterfall Bar Chart”, insert it. Category: Charts.
- Configure inspector controls that exist on this block. Open Chart Settings. Set “Chart Settings — Title”, “Show Title”, “Show Values”, “Show Grid Lines”.
- 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: P&L Waterfall: FY 2024. Saved as `title`. |
| Show Title | On/off toggle in the inspector. On by default. Saved as `showTitle`. |
| Show Values | On/off toggle in the inspector. On by default. Saved as `showValues`. |
| Show Grid Lines | On/off toggle in the inspector. On by default. Saved as `showGridLines`. |
| Show Connectors | On/off toggle in the inspector. On by default. Saved as `showConnectors`. |
| Rotate X Labels | On/off toggle in the inspector. On by default. Saved as `labelRotate`. |
| Canvas Width | Numeric range control in the inspector. Range 300–1200. block.json default: 700. Saved as `svgWidth`. |
| Canvas Height | Numeric range control in the inspector. Range 200–800. block.json default: 400. Saved as `svgHeight`. |
| Bar Width | Numeric range control in the inspector. Range 10–100. block.json default: 42. Saved as `barWidth`. |
| Label Font Size | Numeric range control in the inspector. Range 8–20. block.json default: 12. Saved as `labelFontSize`. |
| Value Font Size | Numeric range control in the inspector. Range 7–18. block.json default: 11. Saved as `valueFontSize`. |
| Positive bars | Color control in the inspector. block.json default: #10b981. Saved as `posColor`. |
| Negative bars | Color control in the inspector. block.json default: #ef4444. Saved as `negColor`. |
| Total bars | Color control in the inspector. block.json default: #6366f1. Saved as `totalColor`. |
| Connector lines | Color control in the inspector. block.json default: #d1d5db. Saved as `connectorColor`. |
| Colors — Background | Color control in the inspector. block.json default: #ffffff. Saved as `bgColor`. |
| Colors — Title | Color control in the inspector. block.json default: #111827. Saved as `titleColor`. |
| Labels | Color control in the inspector. block.json default: #374151. Saved as `labelColor`. |
| Label | Text field in the inspector. |
| Value | Text field in the inspector. |
| Is Total bar | On/off toggle in the inspector. |
When this is the right block
- Bridge / waterfall chart showing cumulative running totals with positive and negative steps — that is the job of Waterfall Bar 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.
- 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 Waterfall Bar Chart block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Waterfall Bar Chart”. It sits under Charts. After insert, open Chart Settings and set “Chart Settings — Title”, “Show Title”, “Show Values”, “Show Grid Lines”.
What makes Waterfall Bar Chart different from other Blockenberg blocks?
Bridge / waterfall chart showing cumulative running totals with positive and negative steps. Inspector labels on this block include “Chart Settings — Title”, “Show Title”, “Show Values”, “Show Grid Lines”.
Is the Waterfall Bar Chart Gutenberg block free?
Yes. Waterfall Bar Chart ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Waterfall Bar 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, Layout, Items).
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 Waterfall Bar Chart from the Gutenberg inserter.