JS API Reference

Welcome to the Highcharts Maps JS (highmaps) 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.map

The map series is used for basic choropleth maps, where each map area has a color based on its value.

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 map series are defined in plotOptions.map.
  3. Options for one single series are given in the series instance array.
Highcharts.chart('container', {
    plotOptions: {
        series: {
            // general options for all series
        },
        map: {
            // shared options for all map series
        }
    },
    series: [{
        // specific options for this series instance
        type: 'map'
    }]
});

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 === map) {
    // code specific to the map series
}

Copyright © 2025, Highsoft AS. All rights reserved.

Highcharts Maps v12.2.0 - Generated from branch master (commit b5a97e06ff), on Mon Apr 07 2025 12:43:22 GMT+0200 (Central European Summer Time)