JS API Reference

Welcome to the Highcharts Core JS (highcharts) Options Reference

These pages outline the chart configuration options, and the methods and properties of Highcharts objects.

Feel free to search this API through the search bar or the navigation tree in the sidebar.

plotOptions.xrange

The X-range series displays ranges on the X axis, typically time intervals with a start and end date.

Configuration options for the series are given in three levels:

  1. Options for all series in a chart are defined in the plotOptions.series object.
  2. Options for all xrange series are defined in plotOptions.xrange.
  3. Options for one single series are given in the series instance array.
Highcharts.chart('container', {
    plotOptions: {
        series: {
            // general options for all series
        },
        xrange: {
            // shared options for all xrange series
        }
    },
    series: [{
        // specific options for this series instance
        type: 'xrange'
    }]
});

TypeScript:

  • the type option must always be set.
  • when accessing an array of series, the combined set of all series types is represented by Highcharts.SeriesOptionsType . Narrowing down to the specific type can be done by checking the type property.
if (chart.options.series?.[0]?.type === xrange) {
    // code specific to the xrange series
}

Copyright © 2025, Highsoft AS. All rights reserved.

Highcharts Core v12.4.0 - Generated from branch master (commit 271dfc62d7), on Thu Sep 04 2025 08:54:27 GMT+0200 (Central European Summer Time)