Skip to main content

How to format tick marks in Chart.js

In Chart.js, "ticks" are the incremental markings that label values along the axis of the chart.

It is possible to write a custom function that determines how tick marks are displayed on the chart. This function can determine the tick label based on the value, the index of the tick (i.e. its position on the axis), and the value of other ticks.

Use the ticks callback

To format Chart.js tick marks, use the ticks.callback property of your scale object. callback is a function that takes up to three arguments:

  • value: the value of the tick
  • index: the tick index in the ticks array
  • ticks: the array of tick objects: {value: number, label?: string | string[], major?: boolean}

The value returned by callback will be displayed on the chart.

Example: Add a currency prefix

Here's a simple example. In Chart.js v3+, we set the options.scales.y.ticks.callback property to add a dollar sign before every value:

{
type: 'bar',
data: {
labels: ['Q1', 'Q2', 'Q3', 'Q4'],
datasets: [
{
label: 'Revenue',
data: [50000, 60000, 70000, 1800000],
backgroundColor: '#3300cc',
},
],
},
options: {
scales: {
y: {
ticks: {
callback: (val) => {
return '$' + val;
},
},
},
},
},
}

Chart.js v2 is very similar, except that scales.yAxes is an array:

{
type: 'bar',
data: {
labels: ['Q1', 'Q2', 'Q3', 'Q4'],
datasets: [
{
label: 'Revenue',
data: [50000, 60000, 70000, 1800000],
backgroundColor: '#3300cc',
},
],
},
options: {
scales: {
yAxes: [{
ticks: {
callback: (val) => {
return '$' + val;
},
},
}],
},
},
}

Here's what the resulting chart looks like:

See the Chart.js documentation for more information.

Example: Hide tick marks

If the value returned by callback is null or undefined, the tick will be hidden. Here's an example that only shows every other tick mark:

{
// in Chart.js v3+
// ...
options: {
scales: {
y: {
ticks: {
callback: (val, index) => {
return index % 2 === 0 ? val : undefined;
},
},
},
},
},
}

{
// in Chart.js v2
// ...
options: {
scales: {
yAxes: [{
ticks: {
callback: (val, index) => {
return index % 2 === 0 ? val : undefined;
},
},
}],
},
},
}

Here's what the chart looks like. You'll notice it has fewer tick marks on the y axis:

Customize tick labels with your own logic

As noted above, use the ticks.callback function to perform custom logic that returns a formatted string. You can perform any logic you like in this function.

For example, let's say we have a chart where we want to abbreviate numbers, for example 100,000 -> 100K and 1,800,000 -> 1.8M. Here's an example where we use an algorithm to determine how the value is displayed on the axis using Chart.js v3+:

{
type: 'bar',
data: {
labels: ['Q1', 'Q2', 'Q3', 'Q4'],
datasets: [
{
label: 'Revenue',
data: [50000, 60000, 70000, 1800000],
backgroundColor: '#3300cc',
},
],
},
options: {
scales: {
y: {
ticks: {
callback: (val) => {
if (!val) return 0;
const units = ['', 'K', 'M', 'B'];
const k = 1000;
const magnitude = Math.floor(Math.log(val) / Math.log(k));
return (
'$' + ' ' + val / Math.pow(k, magnitude) + ' ' + units[magnitude]
);
},
},
},
},
},
}

As you can see, the chart is customized according to the Javascript logic:

In Chart.js v2, the approach is exactly the same except you use scales.yAxes instead:

{
// ...
options: {
scales: {
yAxes: [{
ticks: {
callback: (val) => {
if (!val) return 0;
const units = ['', 'K', 'M', 'B'];
const k = 1000;
const magnitude = Math.floor(Math.log(val) / Math.log(k));
return (
'$' + ' ' + val / Math.pow(k, magnitude) + ' ' + units[magnitude]
);
},
},
}],
},
},
}

If you're using QuickChart, you may want to review Using Javascript functions for instructions on how to include Javascript in chart configs.

Simpler approach: Use the tickFormat plugin

Writing and including Javascript in a chart config can be a hassle. QuickChart offers some built-in convenience functions to format tick marks using the tickFormat plugin.

Let's continue with the above example: we want to abbreviate numbers in our chart labels, for example 100,000 -> 100K and 1,800,000 -> 1.8M. Here's how we'd use the tickFormat plugin:

options: {
plugins: {
tickFormat: {
notation: 'compact'
}
}
}

tickFormat also takes in a prefix or suffix:

  options: {
plugins: {
tickFormat: {
prefix: '$',
notation: 'compact',
},
},
},

If you'd like, you can specify a locale, which determines how numbers are formatted. For example, the DE locale uses . instead of , as a thousands separator:

  options: {
plugins: {
tickFormat: {
prefix: '€',
locale: 'de-DE',
},
},
},

Example: add commas to large numbers

To add thousands separators to large numbers, enable the useGrouping option in the tickFormat plugin:

  options: {
plugins: {
tickFormat: {
useGrouping: true,
},
}
},

For different locales (which may use periods as a separator instead of commas), set the locale option to e.g. en-US, fr-FR.

Reference table

The tickFormat plugin takes all the options of Intl.NumberFormat.

This means you can also do things like specify currencies, percents, or the number of significant digits.

tickFormat attributes

Attribute NameDescription
localeAn Intl.Locale string such as en-US (default), fr-FR, de-DE, en-GB. Full list here
prefixString to prepend to tick label
suffixString to append to tick label
styleThe formatting style to use. Default is decimal. Use decimal for plain number formatting, currency for currency formatting, percent for percent formatting, unit for unit formatting
currencyThe currency to use in currency formatting. Possible values are the ISO 4217 currency codes, such as USD for the US dollar or EUR for the euro. Requires style=currency
unitThe unit to use in unit formatting, such as kilometers, megabyte, percent, etc. Must be a supported unit. Requires style=unit
minimumFractionDigitsThe minimum number of fraction digits to use. Useful to determine the number of decimals shown.
useGroupingtrue to display grouping separators in numbers, such as the thousands separator. false to disable. Defaults true.
applyToDataLabelstrue to override the datalabels plugin formatter
More optionsNumber formatting is highly configurable. See Intl.NumberFormat documentation for the full list of options, including ability to control significant digits, scientific and engineering notation, and so on.

Conclusion

Chart.js offers a flexible means for tick formatting. Use ticks.callback to introduce custom logic, or use QuickChart's tickFormat plugin to handle most common number formatting needs.

Need more help with customizing your tick marks? Please reach out in our community.