You are reading the Icon Map Pro documentation for version 1.1.0.13, which has not been released yet. Go to the latest version (1.1.0.11).

Data labels

Data labels write text from your report beside the circles, images, lines and shapes on the map. Use them to name places, show a value without a tooltip, or build a small card with a title, picture and footer for each item.

Circles on a map, each with a text label on a white container beside it
Classic labels, the default style

Before you start

  • Labels are set in the Labels card of the Format pane. The card appears when at least one layer that can carry labels is switched on: Circles, Images / Icons, Shapes (from data), Shapes (from files), Vector Tiles, Lines or Cells.
  • The text of a label normally comes from a field or a measure, set with conditional formatting (fx). See Conditional formatting.

Add labels to a map

  1. In the Format pane, open Labels > Content and set Display Label to Yes.
  2. Next to Label Text, select fx, choose Field value, and pick the field or measure that holds the text for each row.
  3. Open Labels > Style and choose a Label Style. Classic draws plain map text; the other styles draw each label as a card.
  4. Open Labels > Placement and choose a Position (for circles and images) so the label does not cover its item.

A row draws a label only when it has text. Typing text straight into Label Text gives every item the same label, so use fx for per-row text.

Label only some rows

Display Label takes conditional formatting. Give it a measure that returns yes or no to label only the rows that matter, for example the top ten by sales.

Edit labels in the Layer Manager

New in 1.1.0.11

Once Display Label is Yes, a Data labels row appears in the Layer Manager. Select the row to change the most used options without opening the Format pane.

The Layer Manager with the Data labels row selected and its editor open on the right
The Data labels editor in the Layer Manager
Field in the editor Same as this Format pane setting
Label text Label Text (fixed text only; use fx in the Format pane for text from a field)
Style Label Style
Show Label Visibility
Text size Font Size (min zoom)
Text color Text Color
Position Position (circles & images)
Hide overlapping labels Avoid Overlapping
Visible at zoom Visible From Zoom and Visible To Zoom

The remove button on the row sets Display Label to No. Dragging the row changes where labels sit in the drawing order. See Edit, reorder and remove layers.

Which layers can carry labels

Layer Data labels Notes
Circles Yes Placed with Position (circles & images).
Images and icons Yes Placed with Position (circles & images).
Clusters No Points inside a cluster are not labeled. The cluster shows its own total.
Lines Yes At the middle of the line. Flow and Smoothed Flow have Data Label At Destination. Flow Arcs and Flow Tree have Label Position (None, midpoint or Destination).
Routes Yes At the middle of each link.
Shapes from data Yes Every shape can carry a label.
Shapes from files Yes Shapes matched to a row take that row's label, at every level.
Vector tiles Yes At every level.
Cells Optional Switch on Show data labels in the Cells settings as well. Cells aggregated from points are labeled with the cell's value. Not available for Custom shapes read from a PMTiles file.
Heatmap No
3D columns No
3D models No
ArcGIS layers bound to data No Not labeled from the Labels card.
Icon Map Catalog layers No Catalog layers have their own labels, set in the catalog window.

ArcGIS layers can draw the labels defined in ArcGIS instead: switch on Use ArcGIS Labels for the layer.

Reference layers have their own label settings, separate from the Labels card. See Labels on reference layers.

Label styles

Format pane > Labels > Style > Label Style sets how every data label is drawn. Classic draws plain map text. The other five styles draw each label as a card, typeset with the font you choose, and unlock the card content described in Card content and layout.

Classic

Plain map text, with an optional box behind it (Display Container). This is the default. It uses the map's own fonts: Noto Sans, Open Sans, Roboto, PT Sans or Metropolis, with Bold and Italic switches.

To put a smaller second line under the first, type \n in the text where the line should break, for example Leeds\n1,240 orders.

Halo Text

Labels drawn as text with a soft white halo and no box
Halo Text

Text with a colored halo around the letters and no box. It stays readable over busy basemaps and imagery. Set the Halo Color and its Transparency in the Halo group.

Glass

Labels drawn as light frosted cards that blur the map behind them
Glass

A light card that blurs the map behind it. Set a Tint Color, and choose between a Frosted and a Solid fill Background. Frost (%) sets how strongly the map is blurred.

Dark Glass

Labels drawn as dark frosted cards with light text
Dark Glass

The dark version of Glass. If you leave Text Color at its default black, the text is drawn light so it can be read on the dark card.

Card

Labels drawn as solid white cards with a border and a colored accent stripe
Card

A solid card with its own Fill Color, Border Color and Border Width, and a stripe in the Accent Color.

Neon

Labels drawn as dark cards with a bright glow around them
Neon

A card with a glow in the Accent Color. It suits dark basemaps.

Card content and layout

With any style other than Classic, a label can hold more than one line of text. Each part is a setting in Labels > Content, and each takes fx so it can come from a field.

Diagram of a card label showing the title, image, body text and footer inside the card, and the pointer joining the card to its location
The parts of a card label
Part Setting What it is
Title Title Text Drawn bold above the body. Uppercase Title writes it in capitals.
Image Image A picture shown with the body text: an https address, a data URL or SVG markup.
Body Body Text The main text. This is the same setting as Label Text in the Classic style.
Footer Footer Text Drawn smallest, at the foot of the card, under a fine rule.
Card Card group The box around the text: color, transparency, border, corner radius and margins.
Pointer Pointer A callout tail, or a pin and stem, joining the card to its location.
Links Links group Up to five links that open web pages. See Links on cards.

A label with a title and no body text still draws: the title is used as the text.

Four card labels showing the body text under, above, right of and left of an image
Body Layout: text under, above, right of and left of the image

Body Layout sets where the body text sits when a label has an image: Text under image, Text above image, Text right of image or Text left of image. When the text sits beside the image, Vertical Alignment sets how the shorter of the two lines up against the taller. A card that is too narrow for text beside the image stacks them instead.

Max Width (px) in Size and Zoom sets how wide a card can grow before its text wraps onto another line.

An image given as an https address is only drawn when the server that hosts it allows other websites to read it. If an image does not appear, host it somewhere that allows this or use a data URL.

New in 1.1.0.12

A card label can carry up to five links, for example to a site's web page, a booking page or directions. Each link opens a web page through Power BI, which opens it in a new browser tab. Power BI may ask the user to confirm first.

Six card labels, each showing its links in a different style
The action styles: Action List, Action Buttons, Clean Rows, Call to Action, Action Bar and Tiles
  1. Choose any Label Style except Classic. The Links and Link Format groups appear in the Labels card.
  2. Switch on Links with the switch in the group's header.
  3. Set Number of Links, 1 to 5.
  4. Next to Link 1 URL, select fx, choose Field value, and pick the field that holds each row's web address.
  5. Set Link 1 Text to what the link says, or leave it empty to show the address's site name, such as example.com.
  6. Choose a Style, then adjust it in the Link Format group.

Links past Number of Links keep what was entered for them but are not drawn. A link with no usable URL is not drawn either, so rows without an address show no link.

Links > Style sets how the links are drawn.

Style How the links are drawn
Action List Each link is a row in one inset panel: an icon tile in the button color, the label, an optional second line, and a chevron. This is the default.
Action Buttons Each link is its own soft, full-width button: a tint of the button color, the icon, and a chevron.
Clean Rows Rows run edge to edge across the card, divided by fine lines, like an app's action sheet.
Call to Action The first link is a full-width filled button. The rest are quiet text links under it.
Button Pair The first two links side by side, one filled and one outlined. Any more are text links under them.
Action Bar The links are equal segments along the card's edge, icon over label. More than four wrap onto a second row.
Action Bar, Filled The same bar, filled with the button color.
Tiles A grid of tiles, three to a row (four links make two by two), each a round icon badge over a label of up to two lines.
Buttons, Outline Buttons, Chips, Text Links Filled buttons, outlined buttons, small rounded chips or plain text links, one per line or side by side as Layout sets.

With the Halo Text label style, links are always Text Links, without icons.

Each link has its own settings, numbered 1 to 5. Each takes fx, so every row can have its own links.

Setting What it is
Link 1 Text to Link 5 Text What the link says. Left empty, it shows the address's site name (example.com).
Link 1 URL to Link 5 URL The web address, starting with http or https. Any other kind, such as javascript:, mailto: or a relative path, is ignored.
Link 1 Second Line to Link 5 Second Line A smaller line under the label, such as opening times, a price or a distance. Offered only for Action List, Action Buttons and Clean Rows, the styles that show it.
Link 1 Icon to Link 5 Icon The link's icon, shown when Link Format > Icons is Per Link. A built-in icon name or a picture.

The built-in icons are globe, link, ticket, pin, calendar, clock, phone, mail, info, document, play, download, cart, chart, star, camera, user, home, search, alert, check, chat and heart. Common words work too, such as "website", "directions", "email", "video" or "tickets".

A picture is given as an https address or a data URL. An https picture is drawn only when the server that hosts it allows other websites to read it, as for label images. A picture that cannot be used leaves the link without an icon.

Card labels whose link text and buttons are colored separately, with one card's buttons in a different color taken from a field
Text Color and Button Color set separately, one card's Button Color set by a field

Link Format sets the look of the links. Text Color and Button Color are set separately, and both take fx, so a field can color one card's links differently from the rest.

  • Text Color colors the link text. Not set, it is picked to read on the button, white or near-black, or it is the card's own text color on styles without a filled button.
  • Button Color fills buttons, tiles and icon badges, and colors icons and text links. It is named Link Color for Text Links, Clean Rows and Action Bar, which have no button. Not set, it is the label style's Accent Color.
  • On the dark card styles, Dark Glass and Neon, a dark color used for text or an icon is lightened so it can be read.
  • Clicking a link opens it. It does not select the item or clear the selection. Dragging from a link pans the map as usual.
  • Over a link the pointer is a hand, and the link is highlighted in the Hover Color.
  • On a touch screen, tapping a link opens it.
  • Links show only on a card drawn in full. With Label Visibility set to On mouse over or When selected, they appear with the card. With On mouse over, the card stays up while the pointer moves onto it, so its links can be clicked.
  • Links do nothing where report interactions are switched off, for example on a dashboard tile, or while a drawing or selection tool such as the lasso is in use.

Label Visibility

Labels > Content > Label Visibility decides when labels are on the map.

Option What it shows
Always Every label. This is the default.
On mouse over Only the label of the item under the mouse pointer, like a tooltip. With a card style the label stays up while the pointer is on the card itself.
When selected Only the labels of selected items, and of items highlighted by another visual.
A map where only the circle under the mouse pointer shows its full card, and the other circles show a title only
On mouse over, with Always Show Title on

With a card style and On mouse over or When selected, the extra switch Always Show Title keeps the title of every label on the map and shows the rest of the card on demand.

Placement

Three card labels: one sitting on its location, one with a callout tail, and one raised on a pin and stem
Pointer: None, Callout Tail, and Pin and Stem
  • Position (circles & images) puts the label Above, Below, Left, Right or at the Center of its circle or image. It takes fx, so each row can have its own position.
  • Pointer (card styles except Halo Text) joins a card to its location. Callout Tail draws a tail pointing back at the location, and Position then chooses which side the card sits on. Pin and Stem raises the card above the location on a line; Stem Height (px) sets how far.
  • Orientation (card styles) matters when the map is tilted. Upright (faces the viewer) stands labels up like signs. Flat (lies on the map) lays them on the ground in perspective.
  • Label Height (card styles) is for labels on 3D shapes, such as a room on an upper floor: the label can sit at the Top of Shape, the Base of Shape or on the Ground.
  • Keep Labels Inside Shapes places each polygon's label at the point deepest inside the shape, so labels on irregular shapes stay inside them.
  • Avoid Overlapping hides labels that would collide with another label.

Pointer gap and hanging cards

New in 1.1.0.12

Two card labels: one whose callout tail stops short of its circle, and one hanging below its location on a stem
Pointer Gap leaves a space between the pointer and the circle; a negative Stem Height hangs the card below
  • Pointer Gap (px) leaves a space between the tip of the pointer and the location, so the callout tail or the pin no longer covers the circle or icon. It is shown when Pointer is Callout Tail or Pin and Stem, and measured in screen pixels, so it stays the same when the map is tilted.
  • Stem Height (px) can be negative. A negative height hangs the card below its location: the stem runs down from the location to the top edge of the card.

Settings

All settings are in the Labels card of the Format pane. "Card styles" means every Label Style except Classic.

Content

Setting What it does Default
Display Label Yes or No. Switches labels on. Takes fx, per row. No
Label Visibility Always, On mouse over or When selected. Always
Always Show Title Keeps every title on the map when the rest of the label shows on demand. Card styles, with On mouse over or When selected. Off
Label Text The text of the label. Named Body Text in card styles. Takes fx. Empty
Title Text Bold title above the body. Card styles. Takes fx. Empty
Title Alignment Left, Center or Right. Card styles. Left
Uppercase Title Writes the title in capitals. Card styles. Off
Image A picture shown with the body text. Card styles. Takes fx. Empty
Image Height (px) Height of the image, 8 to 600, at the largest font size. A wide image is narrowed to fit Max Width (px). 96
Body Layout Where the body text sits against the image. Card styles. Text under image
Vertical Alignment Top, Middle or Bottom, when the text is beside the image. Middle
Body Alignment Left, Center or Right. The image takes the same alignment. Card styles. Left
Footer Text Small text at the foot of the card. Card styles. Takes fx. Empty
Footer Alignment Left, Center or Right. Card styles. Left

Card styles only. The switch in the group's header turns the links on. See Links on cards.

Setting What it does Default
Links (switch) Shows the links on every card. Off
Style Action List, Action Buttons, Clean Rows, Call to Action, Button Pair, Action Bar, Action Bar, Filled, Tiles, Buttons, Outline Buttons, Chips or Text Links. Halo Text offers Text Links only. Action List
Number of Links 1 to 5. Links past this number keep what was entered for them but are not drawn. 1
Link 1 Text to Link 5 Text What the link says. Empty shows the address's site name. Takes fx. Empty
Link 1 URL to Link 5 URL An http or https address. Takes fx. Empty
Link 1 Second Line to Link 5 Second Line A smaller line under the label. Action List, Action Buttons and Clean Rows. Takes fx. Empty
Link 1 Icon to Link 5 Icon A built-in icon name, or a picture as an https or data URL. Shown when Icons is Per Link. Takes fx. Empty

Card styles only. The settings offered depend on the link Style.

Setting What it does Default
Text Color Color of the link text. Not set: white or near-black to read on the button, or the card's text color on styles without a filled button. Takes fx. Not set
Text Size (%) 60 to 140, relative to the body text. 100
Weight Regular, Semibold or Bold. Semibold
Uppercase Writes the links in capitals. Off
Button Color The fill of buttons, tiles and icon badges, and the color of icons and text links. Named Link Color for Text Links, Clean Rows and Action Bar. Not set: the Accent Color. Takes fx. Not set
Border Color The border of the buttons. Styles with buttons. Not set: the button color. Not set
Corners Square, Rounded or Pill. Styles with buttons. Rounded
Hover Color The wash over a link under the pointer. Not set: the button color. Not set
Icons None, Arrow, Chevron or Per Link. Arrow and Chevron put one mark after every link. Per Link uses each link's own icon. Not offered for Halo Text. Per Link
Icon Color Match Button or Match Text. With Per Link. Match Button
Layout Vertical or Horizontal. Horizontal wraps onto more rows when the links do not fit Max Width (px). Buttons, Outline Buttons, Chips and Text Links. Vertical
Alignment Left, Center or Right. Buttons, Outline Buttons, Chips, Text Links, and the text links under Call to Action and Button Pair. Left
Position Top of Label, After Title, After Body or Bottom of Label. Clean Rows and the action bars at the top or bottom of a card run to its edge. After Body

Style

Setting What it does Default
Label Style Classic, Glass, Dark Glass, Card, Neon or Halo Text. Classic
Font Family Classic: one of the map's fonts (Noto Sans, Open Sans, Roboto, PT Sans, Metropolis). Card styles: any font. Classic draws in Noto Sans; card styles in Segoe UI
Bold, Italic Classic only. Off
Text Color Color of the text. Takes fx. #000000
Accent Color The stripe on a Card, the glow of Neon, and the pin at the foot of a stem. Takes fx on the Card style and on stems; Neon keeps one color. #2563EB
Accent Width Card: the width of the stripe, 0 to 40 pixels. A stripe wider than 4 pixels moves the text across. Takes fx. 4
Background Frosted blurs the map behind the label. Solid fill draws the fill without the blur. Glass, Dark Glass and Neon. Frosted
Frost (%) How strongly the map behind the label is blurred. 0 turns the blur off. 60

Container, Card or Halo

This group is named Container for Classic, Card for Glass, Dark Glass, Card and Neon, and Halo for Halo Text. The settings it offers depend on the style.

Setting What it does Default Styles
Display Container Yes or No. Draws the box behind the text. Takes fx. Yes Classic
Fill Color Color of the box. Named Tint Color for Glass and Halo Color for Halo Text. Takes fx. #FFFFFF Classic, Card, Glass, Halo Text
Transparency 0 to 100. Takes fx. 20 All
Border Color Takes fx. #000000 Classic, Card
Border Width 0 to 20. Takes fx. 1 Classic, Card
Border Radius 0 to 90. 0 gives square corners. Takes fx. 0 All except Halo Text
Margins Space between the text and each edge of the box. 0 All except Halo Text

Placement

Setting What it does Default
Orientation Upright (faces the viewer) or Flat (lies on the map). Card styles. Only visible when the map is tilted. Upright
Pointer None, Callout Tail or Pin and Stem. Card styles except Halo Text. Pin and Stem is not offered for flat labels. None
Stem Height (px) -300 to 300. With Pin and Stem. A negative height hangs the card below its location. 36
Pointer Gap (px) 0 to 100. The space left between the tip of the pointer and the location. With Callout Tail or Pin and Stem. 0
Label Height Top of Shape, Base of Shape or Ground, for labels on 3D shapes. Card styles. Top of Shape
Position (circles & images) Above, Below, Left, Right or Center. Shown when Pointer is None. Takes fx. Center
Position Above, Below, Left or Right: the side of its location each card sits on. Shown when Pointer is Callout Tail. Takes fx. Above
Keep Labels Inside Shapes Places each polygon label at the point deepest inside its shape. Off
Avoid Overlapping Hides labels that would collide. Off

Size and Zoom

Setting What it does Default
Font Size (min zoom) Text size, 0 to 100, at Font Min Zoom and below. Sizes of 12 or more stay sharp. 16
Font Min Zoom 0 to 24. 5
Font Size (max zoom) Text size at Font Max Zoom and above. 16
Font Max Zoom 0 to 24. 10
Max Width (px) 60 to 800. Longer text wraps onto more lines. Card styles. 220
Visible From Zoom Labels are hidden when the map is zoomed out past this level. 0
Visible To Zoom Labels are hidden when the map is zoomed in past this level. 24
Z-Index Where labels sit in the drawing order. Higher draws on top. 950

Between Font Min Zoom and Font Max Zoom the text size changes smoothly from one size to the other. Set the two sizes differently to make labels grow as readers zoom in.

Tips and limits

  • Labels dim with their items when a selection is active. To keep labels at full strength, switch off Format pane > Interactivity > Item selection > Include Labels. See Selection, cross-filtering and highlighting.
  • Avoid Overlapping also works with On mouse over and When selected: hidden labels take no room.
  • A report saved with the earlier Pill style draws its labels as Glass.
  • Label styles are drawn as designed in Windows high contrast mode; they do not switch to the high contrast colors.
  • The Text, Alignment and Container layout of this card belongs to the Legacy engine. See the documentation for 1.1.0.9 and earlier.