# Title

The chart title defines text to draw at the top of the chart.

# Title Configuration

Namespace: options.plugins.title, the global options for the chart title is defined in Chart.defaults.plugins.title.

Name Type Default Scriptable Description
align string 'center' Yes Alignment of the title. more...
color Color Chart.defaults.color Yes Color of text.
display boolean false Yes Is the title shown?
fullSize boolean true Yes Marks that this box should take the full width/height of the canvas. If false, the box is sized and placed above/beside the chart area.
position string 'top' Yes Position of title. more...
font Font {weight: 'bold'} Yes See Fonts
padding Padding 10 Yes Padding to apply around the title. Only top and bottom are implemented.
text string|string[] '' Yes Title text to display. If specified as an array, text is rendered on multiple lines.

Note

If you need more visual customizations, you can implement the title with HTML and CSS.

# Position

Possible title position values are:

  • 'top'
  • 'left'
  • 'bottom'
  • 'right'

# Align

Alignment of the title. Options are:

  • 'start'
  • 'center'
  • 'end'

# Example Usage

The example below would enable a title of 'Custom Chart Title' on the chart that is created.

const chart = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        plugins: {
            title: {
                display: true,
                text: 'Custom Chart Title'
            }
        }
    }
});

This example shows how to specify separate top and bottom title text padding:

const chart = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        plugins: {
            title: {
                display: true,
                text: 'Custom Chart Title',
                padding: {
                    top: 10,
                    bottom: 30
                }
            }
        }
    }
});
Last Updated: 10/28/2024, 1:36:05 PM