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

Label Configuration

The labels tab lets you display text labels on map features. Two label types are available:

Field

Labels are drawn from a vector-tile property — for example, showing the name of each region, postcode, or station.

  • Property — select the attribute to display as the label text.
  • Font size — the label text size in pixels.
  • Color — the label text color.
  • Halo color — the color of the outline/halo around the text. A contrasting halo (e.g. white text with a dark halo, or dark text with a white halo) improves readability on busy backgrounds.
  • Halo width — the width of the halo in pixels.
  • Offset — horizontal and vertical offset from the feature's anchor point, in pixels.

Label Placement

Label placement depends on the geometry type:

  • Polygons — labels are centered on the polygon centroid.
  • Points — labels are positioned near the point with smart collision avoidance, so overlapping labels are automatically hidden.
  • Lines — labels follow the line path.

MapLibre handles collision detection automatically — when many features are visible, only non-overlapping labels are shown.

None

Disable labels. No text is rendered on features.