M ChartM Chart
Users
Pro
Highcharts
Developers
Download
GitHub
Users
Pro
Highcharts
Developers
Download
GitHub
  • User Guide

    • User Guide
    • Libraries
    • Types of Charts
    • Creating a Chart
    • Multiple Sheets
    • Scatter & Bubble Charts
    • Radar & Radar Area Charts
    • Treemap Charts
    • Boxplots & Violin Charts
    • Chart Shortcode
    • Block Editor
    • CSV Import & Export
    • Settings
    • Chart Units
    • Themes
    • Accessibility
    • Duplicating Charts
    • Example Charts

Themes

Available since version 1.8 (Chart.js).

Themes control the color palette and point styles used by Chart.js charts. The active default theme is selected in Chart → Settings.

Built-in Themes

M Chart ships with five themes:

ThemeDescription
M ChartThe default theme — M Chart's own brand palette (blues, gray, peach, coral, red)
Chart.jsThe color palette M Chart used as its default prior to version 2.2
Chart.js 3.xUses the default Chart.js 3.x color palette
Color Blind SafeThe Okabe–Ito palette, designed to be distinguishable for users with common forms of color blindness, paired with distinct point shapes per series
Highcharts 4.xApproximates the default color scheme from Highcharts 4

What changed in 2.2

The built-in default theme was switched to the new M Chart palette. Charts left on the default theme will look visually different after updating — this is expected and no action is required. The palette M Chart used as its default before 2.2 is preserved as the Chart.js theme, so switching a chart to it restores the previous look.

Custom Themes

Create custom themes by adding PHP files to an m-chart-chartjs-themes directory inside your active WordPress theme folder:

wp-content/themes/your-theme/
└── m-chart-chartjs-themes/
    └── my-theme.php

A theme file returns an array with colors and optionally points:

<?php

/**
 * Theme Name: My Custom Theme
 */

return [
	'colors' => [
		'#e63946',
		'#457b9d',
		'#2a9d8f',
		'#e9c46a',
		'#f4a261',
		'#264653',
	],
];

Point Styles

Optionally customize the point markers used on line/scatter charts:

<?php

/**
 * Theme Name: My Custom Theme
 */

return [
	'colors' => [ '#e63946', '#457b9d' ],
	'points' => [
		[ 'point' => [ 'pointStyle' => 'circle' ] ],
		[ 'point' => [ 'pointStyle' => 'rect' ] ],
		[ 'point' => [ 'pointStyle' => 'triangle' ] ],
	],
];

Once your file is in place, the theme will appear in the theme selector on each chart edit screen and in the default theme setting.

Per-Chart Theme

Each chart can use a different theme regardless of the site-wide default. Select the theme in the Theme dropdown on the chart edit screen.

Last Updated: 6/24/26, 10:21 PM
Contributors: Jamie Poitra
Prev
Chart Units
Next
Accessibility