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.
  • Colour — the label text colour.
  • Halo colour — the colour 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 centred 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.