This is the official Chart Block documentation, your guide to turning raw numbers into interactive charts inside the WordPress block editor.
Start with Getting Started to install and activate the plugin, then move on to How To Use to pick a chart type, enter your datasets, and style the result. If you get stuck, the FAQs answer the questions people ask most.
Chart Block turns rows of numbers into interactive charts right inside the block editor, with no code and no separate charting tool.
You enter your labels and values as datasets, pick a chart type, and the block draws the chart as you edit. From there you can set the width and height, background and text colors, scales and grid lines, add a title and subtitle, and let visitors download the chart.
Typical uses include sales reports, survey results, and site statistics. With Chart Block Pro you can also keep a chart in sync with live data from Google Sheets or WooCommerce.
Chart Block runs on a standard WordPress site. Before you begin, check that yours meets these minimums:
Chart Block is listed in the WordPress plugin directory, so you can install it from the dashboard, upload the zip file yourself, or add it straight from the block editor.
The quickest route: install Chart Block without leaving your dashboard.
When the install finishes, click Activate to switch Chart Block on.
Use this method when you already have the chart-block.zip file on your computer.
Handy when you are already editing a page and want to drop a chart in right away.
Right after activation, Chart Block opens a short welcome screen.
Click Allow & Continue to subscribe to the newsletter and get plugin updates and news.
You then arrive at the Chart Block dashboard.
If you bought Chart Block Pro, activate your license key to unlock the Pro features, such as Live Data Hub and the extra chart types.
Go to Plugins » Chart Block » Active License.
Your plugin is ready. Head to How To Use to add your first chart.
You can easily create charts with the Chart Block.
Enter your data, choose a chart type, and add labels as needed. The styling controls let you adjust the colors and typography to match the chart to your site.
You can find Chart Block in the block library and add it anywhere on your page.
The block arrives with a default design that you can edit right away.
Select the block, and its settings open in the sidebar on the right.
The Chart Type dropdown lists 10 chart types: Combo, Bar, Pie, Line, Scatter, Radar, Gauge, Funnel, Heatmap, and Candlestick. The free version includes the Combo chart, and the other nine come with Chart Block Pro (see More Chart Types). Pick the type that presents your data best.
You can manage the chart's datasets from the Add or Remove Datasets panel. Edit a dataset to update its data, click Add New Dataset to add another one, or click the ✕ icon to remove it.
You can customize the chart's appearance from the Chart Settings panel. Select the chart Type, then set its Width and Height. Pie, Doughnut, and Polar Area charts use a single dataset. You can also choose the Background and Text Color, show or hide the X and Y scales and grid lines, and set the Grid Line Color.
You can add a title and subtitle from the Title & Subtitle Settings panel. Turn on Show Title to display a title, then enter your text and set its Font Size and Color. Turn on Show Subtitle to display a subtitle below the title.
You can let visitors download your chart from the Download Settings panel. Turn on Download Button to display a Download Chart button above the chart.
The features in this section are available with Chart Block Pro. Pro
You can connect a spreadsheet to your chart and keep its data up to date with Live Data Hub. Turn it on, then choose how often the chart syncs from the Sync every dropdown. The editor shows the latest synced values.
Click Refresh now to sync the data immediately, or Setup page to connect your spreadsheet.
You can connect your chart to live data from the setup page, under Chart > Help And Demo > Resources. Turn on Live Data Hub, then select a data source: Google Sheets or WooCommerce. Click Setup Guidelines and follow the steps to complete the connection. The status changes from Disconnected once your data source is connected.
Chart Block Pro adds 9 more chart types: Bar, Pie, Line, Scatter, Radar, Gauge, Funnel, Heatmap, and Candlestick. Select one from the Chart Type dropdown, then adjust the settings to match your data and design.
You can display a chart anywhere on your site with a shortcode.
Build it once, then paste its shortcode into any page, post, or widget instead of rebuilding it each time.
Go to the dashboard menu and click Add New Chart.
The block editor opens, where you can build and style the chart. When you are happy with it, click Save and copy the shortcode shown on the page.
Now go back to the dashboard menu.
Paste the shortcode into any page, post, or widget area where you want it to appear. Use the live preview to check how it looks before you publish.
Publish or save the page, then visit your site to see the result.
Chart Block is a Gutenberg block that turns your data into charts. You can use it for sales reports, survey results, statistics, and other data you want visitors to understand at a glance.
The free version includes the Combo chart. Chart Block Pro adds 9 more: Bar, Pie, Line, Scatter, Radar, Gauge, Funnel, Heatmap, and Candlestick.
Yes. You can change the width, height, background, text color, X and Y scales, grid lines, and grid line color, and add a title and subtitle with their own font size and color.
Yes. Turn on Download Button to let visitors download the chart.
Yes. With Live Data Hub in Chart Block Pro, you can connect your chart to a spreadsheet and choose how often the data syncs.
Yes. You can set the chart width as a percentage, so it adapts to different screen sizes.
No. You can create and customize charts directly in the block editor without writing code.
Install and activate the plugin, then add Chart Block from the block library. Choose a chart type, enter your data, adjust the settings in the sidebar, and publish the page.