Frequently asked questions
Short answers to the questions we hear most, with links to the pages that go deeper. For buying and license questions, see the Purchasing FAQ.
Building maps
What's the best way to debug my map?
Turn on Format pane > Diagnostics > Diagnostic Tools > Show Data Configuration Summary. It shows how many rows Power BI sent, which layer each row belongs to, and warnings about layers that are on with no rows or off with rows.
Icon Map Pro decides what to draw from the fields each row fills in. When a value comes from a DAX measure it can be hard to tell what the visual receives. To see it, copy the map visual, paste the copy on the same report page and change the copy to a table. The table shows the data passed from the field wells. Values set through conditional formatting are not shown, but you can add those measures to the table as extra fields.
More in Troubleshooting.
Can I add multiple layers to my map?
Yes. Several data layers can share one map, fed from one table. Each row is drawn by the layer whose fields it fills in, so the data has to be modeled to match. See Combine several layers in one map.
How many rows of data does Icon Map Pro support?
Most Power BI visuals display up to 30,000 rows, and that is the default for Icon Map Pro. You can raise it to 480,000 in steps of 30,000 with Format pane > Data Layers > Data Rows > Maximum data rows. More rows can affect performance, and some layer types handle large numbers better than others. See Data rows and limits.
Why don't my WKT shapes appear?
Power BI can hold a limited number of characters in one text value, so long WKT shapes are often cut off and cannot be drawn. To check, add a measure such as WKT Length = LEN ( MAX ( 'Table'[WKT Column] ) ) and look for values at the limit of 32,766 characters. See Shapes from data (WKT and GeoJSON) for how to deal with it.
Which map engine does my map use?
New maps use the Modern engine. Reports built before the Modern engine existed stay on the Legacy engine until you change Format pane > Rendering > Map engine. This documentation describes the Modern engine. See Modern and Legacy engines.
Which version am I running?
Format pane > Icon Map Pro shows the version on its first line. See Release notes.
Environments
Can I use Icon Map Pro in Power BI Embedded?
Yes. The standard visual works in Power BI Embedded with a license key. See License types, or contact sales@tekantis.com.
Can I use Icon Map Pro in Publish to web reports?
Yes, with a license key. See License types, or contact sales@tekantis.com.
Can I use Icon Map Pro with Power BI Report Server?
Yes, with a license key. Icon Map Pro has been tested with the May 2025 (Update) and January 2026 versions of Power BI Report Server. See Power BI Report Server (on-premises).
Does it work without internet access?
Yes, with some setup. The built-in basemaps, the icon library and the Icon Map Catalog are hosted online, so an air-gapped environment needs its own basemap source and an air-gapped license key. See Power BI Report Server (on-premises).
Which languages is Icon Map Pro available in?
English, German, Spanish, French and Portuguese. The visual follows the language of the report. See Languages.
Security
Can Icon Map Pro be certified?
No. Microsoft only certifies visuals that make no calls to external services, and a map has to load its basemap from one. See Security and certification.
Does Icon Map Pro send my data anywhere?
The rows of your report are drawn inside the visual. What the visual does request from external services, and what its usage telemetry contains, is set out in Security and certification.