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.