Super Map Polygon Labels – QBeeQ

🚨 This functionality is currently in Beta and is not available to all customers.

This guide is intended for Sisense Dashboard Designers and provides instructions for advanced functionality to display KPI values as labels on polygons.

ℹ️

This functionality is available for the Super Map as of Q2026.01.07

Before you start

Planning for your labels

⚠️

KPI labels are only supported for US States and US Counties layers.

Compilation

The Super Map add-on will need to compile when the config.js file is saved.

It is recommended to open a separate window or tab and navigate to Server & Hardware > Add-ons. If the Add-ons page is open, the compilations will happen automatically.

Setting label limits

The Super Map allows for multiple labels to be displayed within a polygon. In the config.js, this value is defaulted to 3, but can be changed as needed.

ℹ️

Once the limit is reached, any additional values will be disabled and not selectable by the Dashboard Designer.

To change the limit of labels that can be selected and displayed:

Navigate to Admin > App Configuration > File Management > Plugins > QBeeQGeojsonMap

Navigate to Plugins > QBeeQGeojsonMap > js

Locate and open the config.js file

Locate polygonLabelsMaximum and update the value

Save the file

Polygon Centers

To display labels, each layer must include a defined center point of the polygon in its vector definition. The hasCentersDefined array contains the list of layers that already have center coordinates specified in the objectMapping.js file.

⚠️

KPI labels are currently supported for US States and US Counties layers.

If you need to add a new layer using a custom GeoJSON that includes center information, please reach out to support@qbeeq.io for assistance.

Selecting data and KPIs to display

In the data panel, select data and add to the Polygon Tooltip section

In the design panel, navigate to the Advanced Settings > Polygon Labels.

For each layer, open the dropdown and view the KPIs that can be displayed on the polygons.

ℹ️

Only layers compatible with polygon labels are displayed in this section.

The order in which the KPIs are selected in the dropdown is the order (pos.) in which they are virtually displayed within the polygon.

Once the maximum number (defined in the config.js) is selected, any other checkboxes should be disabled.

Formatting the labels

ℹ️

KPIs that are set to display on polygons will only display the KPI values, not their labels. Labels will be displayed in the tooltip.

Use the native data formatting in the Data Panel to format the KPIs as you want them to display.

Use the controls in the section Advanced > Polygon Labels to format how the labels are visually displayed within a polygon:

Text color

Text outline

Outline color

Outline width