Packages

mapbox-gl

3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed

Your version

3.18.0

14 Jan 2026Where it was published

3.34.2 is the newest release of 3.x.

In short

7 new14 fixed

Release note

Features and improvements

  • Add scaleFactor support for images within text-field.

  • Add showButton option to GeolocateControl that allows hiding the control button.

  • Add followUserLocation option and setFollowUserLocation method to GeolocateControl to control whether the map follows the user's location.

  • Improve GeolocateControl timeout handling.

  • Add support for text-rotate, text-size, and text-offset properties in appearances.

  • Add shadow-draw-before-layer property to directional light, allowing control over shadow draw order in the layer stack.

  • Add model-allow-density-reduction property to model layers. (h/t @JoshuaJMoore)

Bug fixes

  • Fix interaction handlers not working on model layers.

  • Fix stretchable icons without icon-text-fit rendering with an incorrect size.

  • Fix icon-size not working correctly with coalesce expressions.

  • Fix raster-color interpolation when using nearest raster-resampling.

  • Fix render cut off for elevated raster-layer rendering in ortho projection range.

  • Fix symbol placement with optional and missing parts.

  • Expose all error properties for GeolocateControl error event (h/t @lucavb).

  • Fix an error when querying multipolygons in dynamic: true mode.

  • Fix AttributionControl links sanitization.

  • Fix appearances with no icon-size using the default value instead of the layout-defined one.

  • Fix updates to model source via ModelSource.setModels while models are still loading.

  • Fix polygon clipping precision errors causing rendering artifacts in elevated structures.

  • Preserve featuresets in map.getStyle() output.

  • Expose TypeScript types from @mapbox/mapbox-gl-style-spec for direct imports.