Charts

Last modified: October 16, 2026

Introduction

Charts allow you to display data series visually on your app pages in a wide range of charts.

The chart widgets are part of the Charts module, which you can download from the Mendix Marketplace. The widgets are based on the Plotly JavaScript library. For the configuration of the chart widgets, see Charts in the Marketplace Guide.

Chart Types

The Charts module contains these chart widgets:

  • Area chart – a line chart with a fill to the X-axis
    Area chart with three stacked series
  • Bar chart – horizontal bars, grouped or stacked
    Horizontal bar chart with three grouped series
  • Bubble chart – add a size dimension to your chart
    Bubble chart with three series of different-sized bubbles
  • Column chart – vertical bars, grouped or stacked
    Column chart with two grouped series
  • Heat map – show data values by color in a 2D matrix
    Heat map with a grid of colored cells and a color scale
  • Line chart – straight or curved lines, with or without markers
    Line chart with three series
  • Pie chart – a pie or a doughnut chart
    Pie chart with three slices
  • Time series – show data ordered by time
    Time series area chart with two series and a range slider

The widgets have settings in Studio Pro to customize the look and feel, and support on click actions and custom tooltips. For details on each chart type, see Charts.

If the standard chart settings are not sufficient for your purposes, see Chart Advanced Cheat Sheet for information on the advanced configuration of your charts. To change settings live in the running app, use the Chart Playground.

Only plotly.js features available in the version bundled with your Charts widget release can be used when configuring charts.

To create a chart with a variable number of data series, see Create a Dynamic Series Chart.

Custom Chart

With the Custom chart widget, you can build all chart types that are possible with Plotly by configuring the chart with JSON. Use it when the standard chart widgets do not support the chart you need. For more information, see Use Custom Chart.

Any Chart

For the legacy Any Chart documentation, see Any Chart Widgets, Any Chart Building Blocks, and Any Chart Cheat Sheet.

For the legacy chart widgets below version 3.0.0, see Chart Configuration.

Performing Basic Functions

For more information on how to add widgets to a page, view their properties, and arrange them, see Adding Elements on a Page, Viewing Element Properties, and Arranging Elements on a Page sections in Page.

Documents in This Section

  • Chart Configuration
  • Describes the configuration options of the legacy chart widgets, below version 3.0.0.

  • Chart Advanced Cheat Sheet
  • Shows, with JSON examples, how to use the advanced layout, series, and configuration options of the chart widgets.

  • Any Chart Widgets
  • A reference for the configuration of the Any Chart widget to pass the correct values to plotly. This enables you to draw a wide variety of charts

  • Any Chart Cheat Sheet
  • Shows, with examples, how the most common types of chart can be configured using the Any Chart Widget