Skip to main content Link Menu Expand (external link) Document Search Copy Copied


You can use different chart types by utilizing the visualisation key of the Matatika dataset YAML file.

The visualisation key contains information about displaying the chart for the insight.


visualisation: |-
    {"chartjs-chart": {"chartType": "bar"}}

ChartJS charts

Beautiful ChartJS data visualisations can be achieved with the chartjs-chart visualisation type.

visualisation: |-
    {"chartjs-chart": {"chartType": "bar"}}
Value Description
bar Bar Chart
line Line Chart.
doughnut Doughnut Chart.
pie Pie Chart.
bubble Bubble Chart.
scatter Scatter Chart.
treemap Treemap Chart.

For more information on Chart.js, see their documentation at

HTML table

Basic table layout for datasets can be achieved with the html-table visualisation type.

visualisation: |-
    {"html-table": {}}

HTML metric

Metric layout for datasets can be achieved with the html-metric visualisation type.

visualisation: |-
    {"html-metric": {}}

This visualisation is designed to be used as either a single metric of a total, or to display a total and its breakdown.

The first value you pass will be displayed as a big centered value, and every subsequent value will be smaller and in a row below the first. This lets you do things like show the total number of tests run, then the number of passed and failed below.

Color Options

By default the background is white and the text is black, but in all our datasets you can pass a palette setting through the chart’s metadata:

metadata: |-
      "name": "elementary_test_results", 
      "label": "metric", 
      "related_table": {
        "columns": [
        "aggregates": [
            {"name": "total", "label": "Total", "description": "Total"},
            {"name": "pass", "label": "Pass", "description": "Pass"},
            {"name": "fail", "label": "Fail", "description": "Fail"}
    "palette": [[255, 255, 255],[0, 0, 0],[0, 255, 0],[255, 0, 0]]

For our html-metric, the first color is always the background, then every other color will apply in order to each of the aggregates you are visualising. If you only provide 2 colors and 2 aggregates then you get:

  • The first color as background
  • The second color on the first aggregate
  • The default black text color for the second aggregate

Further Reading: