a specification for maplibre styles
Last release 2 days ago
25 Aug 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
89 releases ยท first in 2021
Release timeline
89 releases since 2021Releases
- 26.4.125 Aug 2026
Release notes
Open source โโจ Features and improvements
- Publish the ESM build (
dist/index.mjs, referenced bypackage.json#module) as one module per source file instead of a single bundle, so that bundlers which eliminate dead code at module granularity can drop unused parts of the package (#1829) (by @ahocevar)
๐ Bug fixes
Additional notes
Open source โโจ Features and improvements
- Publish the ESM build (
dist/index.mjs, referenced bypackage.json#module) as one module per source file instead of a single bundle, so that bundlers which eliminate dead code at module granularity can drop unused parts of the package (#1829) (by @ahocevar)
๐ Bug fixes
- Publish the ESM build (
- 26.4.024 Aug 2026
Release notes
Open source โโจ Features and improvements
- Enable data-driven
icon-rotation-alignment(#1836) (by @Turbo87) - Make
urloptional for image sources. An image source can now be defined with onlytypeandcoordinates; it renders nothing until an image is set at runtime (#1817)
๐ Bug fixes
Additional notes
Open source โโจ Features and improvements
- Enable data-driven
icon-rotation-alignment(#1836) (by @Turbo87) - Make
urloptional for image sources. An image source can now be defined with onlytypeandcoordinates; it renders nothing until an image is set at runtime (#1817)
๐ Bug fixes
- Enable data-driven
- 26.3.024 Aug 2026
Release notes
Open source โโจ Features and improvements
- Add
semiliteraloperator for expressions inside arrays and objects (#951) (by @sargunv) - Add
symbol-height-offsetandsymbol-height-anchorproperties tosymbollayers to allow icons and text to be elevated above the ground (#1508) (by @HatulaPro)
Additional notes
Open source โโจ Features and improvements
- Add
semiliteraloperator for expressions inside arrays and objects (#951) (by @sargunv) - Add
symbol-height-offsetandsymbol-height-anchorproperties tosymbollayers to allow icons and text to be elevated above the ground (#1508) (by @HatulaPro)
- Add
- 26.2.123 Jul 2026
Release notes
Open source โโจ Features and improvements
๐ Bug fixes
- Fix
fill-extrusion-rounded-corner-distancebeing documented as anpaintinstead of anlayoutproperty as implemnented (#1784) (by @CommanderStorm)
Additional notes
Open source โ๐ Bug fixes
- Fix
fill-extrusion-rounded-corner-distancebeing documented as anpaintinstead of anlayoutproperty as implemnented (#1784) (by @CommanderStorm)
- Fix
- 26.2.023 Jul 2026
Release notes
Open source โโจ Features and improvements
๐ Bug fixes
- Support
global-state(and othervalue-typed) expressions inprojectionDefinitionproperties such asprojection.type(#1772) (by @CommanderStorm)
Additional notes
Open source โโจ Features and improvements
๐ Bug fixes
- Support
global-state(and othervalue-typed) expressions inprojectionDefinitionproperties such asprojection.type(#1772) (by @CommanderStorm)
- Support
- 26.1.014 Jul 2026
- 26.0.012 Jul 2026
Release notes
Open source โโจ Features and improvements
- Add a
severityfield toValidationError. It is only set on non-fatal findings ("warning"); an absentseveritystill means"error", so existing consumers are unaffected (#1751) (by @HarelM) - โ ๏ธ Allow debugging runtime warnings by attaching location of an warning and what will happen (#1740) (by @CommanderStorm)
๐ Bug fixes
Additional notes
Open source โโจ Features and improvements
- Add a
severityfield toValidationErrorand imporve legacy filter recognition (#1752) (by @HarelM) - โ ๏ธ Allow debugging runtime warnings by attaching location of an warning and what will happen (#1740) (by @CommanderStorm)
- Add a
- 25.0.27 Jul 2026
- 25.0.129 Jun 2026
- 25.0.015 Jun 2026
Release notes
Open source โโจ Features and improvements
- โ ๏ธ Change legacy filter expression validation to add suggestions on invalid expressions (#1709) (by HarelM)
- Allow global state expressions in
fill-layer-opacityandline-layer-opacity. (#1699) (by @CommanderStorm)
Additional notes
Open source โโจ Features and improvements
- โ ๏ธ Change legacy filter expression validation to add suggestions on invalid expressions (#1709) (by HarelM)
- Allow global state expressions in
fill-layer-opacityandline-layer-opacity. (#1699) (by @CommanderStorm)
- 24.10.08 Jun 2026
Release notes2 sources agree
Open source โโจ Features and improvements
- Added
{line,fill}-layer-opacitypaint property. It applies opacity to the whole layer as a whole layer so overlapping features change in an uniform way. (#1650) (by @CommanderStorm)
- Added
- 24.9.07 Jun 2026
Release notes2 sources agree
Open source โโจ Features and improvements
- Allow
fill-colorwhenfill-patternis set, for SDF fill pattern colorization (#1683) (by @bradymadden97)
๐ Bug fixes
- Allow
- 24.8.55 May 2026
Release notes2 sources agree
Open source โ๐ Bug fixes
- Added missing exported types (#1638) (by @scottg521)
- 24.8.45 May 2026
Release notes
Open source โโจ Features and improvements
๐ Bug fixes
- Replace rw with node:fs. Resolves #1625 (#1635) (by @birkskyum)
Additional notes
Open source โ๐ Bug fixes
- Replace rw with node:fs. Resolves #1625 (#1635) (by @birkskyum)
- 24.8.33 May 2026
Release notes2 sources agree
Open source โ๐ Bug fixes
- Restore Specification type exports dropped in v24.8.2 (#1627) (by @birkskyum)
- 24.8.21 May 2026
- 24.8.13 Apr 2026
Release notes2 sources agree
Open source โโจ Features and improvements
- Add
AllPaintPropertiesandAllLayoutPropertiestypescript definitions (#1579) (by @CommanderStorm) - Update TS definitions to allow
varas the 3rd arg of comparator functions (#1564) (by k-yle)
๐ Bug fixes
- Add
- 24.8.02 Apr 2026
Release notes2 sources agree
Open source โโจ Features and improvements
- Enable data driven stylng for
line-{cap,round-limit,miter-limit}(#1566) (by @CommanderStorm)
- Enable data driven stylng for
- 24.7.08 Mar 2026
Release notes2 sources agree
Open source โโจ Features and improvements
- Validate that
rasterlayers do not specify bothresamplingandraster-resamplingpaint properties (#1532) (by larsmaxfield)
- Validate that
- 24.6.026 Feb 2026
Release notes2 sources agree
Open source โ - 24.5.023 Feb 2026
Release notes2 sources agree
Open source โโจ Features and improvements
- Add "unit" option to "number-format" (#1335) (by ginnyTheCat)
- Add
resamplingpaint property to raster, hillshade, and color relief layers (#1447) (by larsmaxfield) - Include 'transparent' as a permitted color name (#1442) (by zstadler)
- Migrate docs to zensical (#1394) (by CommanderStorm)
- 24.4.115 Dec 2025
Release notes2 sources agree
Open source โ - 24.4.010 Dec 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.3.1:
โจ Features and improvements
- Allow global state expressions in layer visibility (#1364)
- Only alert to an unknown or required object-properties being undefined instead of any object-property being undefined (#1415)
๐ Bug fixes
- The optional
centerproperty is now validated to be a[lon,lat]array (#1372)
Additional notes
Open source โโจ Features and improvements
- Update Node.js to 24.11 (#1418)
- Allow global state expressions in layer visibility (#1364)
- Only alert to an unknown or required object-properties being undefined instead of any object-property being undefined (#1415)
๐ Bug fixes
- The optional
centerproperty is now validated to be a[lon,lat]array (#1372)
- 24.3.130 Oct 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.3.0:
๐ Bug fixes
- The validator no longer fails if the style lacks a
glyphsproperty (#1347)
Additional notes
Open source โ๐ Bug fixes
- The validator no longer fails if the style lacks a
glyphsproperty (#1347)
- The validator no longer fails if the style lacks a
- 24.3.015 Oct 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.2.0:
โจ Features and improvements
- Add optional
encodingproperty to vectorsourceto allow for MapLibre Tile vector sources
Additional notes
Open source โโจ Features and improvements
- Add optional
encodingproperty to vectorsourceto allow for MapLibre Tile vector sources
- Add optional
- 24.2.027 Sept 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.1.1:
โจ Features and improvements
- Add note regarding visual artifacts that can appear with large width/size/offset values on vector tile layers, highlight remediation options (#4160)
- Implement data-driven styling support for
line-dasharray(#5812)
๐ Bug fixes
- Replace additional spread operator (
...) due to esbuild limitations (#1297)
Additional notes
Open source โโจ Features and improvements
- Add note regarding visual artifacts that can appear with large width/size/offset values on vector tile layers, highlight remediation options (#4160)
- Implement data-driven styling support for
line-dasharray(#5812)
๐ Bug fixes
- Replace additional spread operator (
...) due to esbuild limitations (#1297)
- 24.1.119 Sept 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.1.0:
๐ Bug fixes
- Replace spread operator (
...) due to esbuild limitations (#1286)
Additional notes
Open source โ๐ Bug fixes
- Replace spread operator (
...) due to esbuild limitations (#1286)
- Replace spread operator (
- 24.1.015 Sept 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v24.0.0:
โจ Features and improvements
- Added
global-stateparameter tofeatureFilterfunction (#1279)
Additional notes
Open source โโจ Features and improvements
- Added
global-stateparameter tofeatureFilterfunction (#1279)
- Added
- 24.0.012 Sept 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.3.0:
โจ Features and improvements
- โ ๏ธ Change passing
global-stateto expression from theevaluatefunction to the constructor (#1267) - you can add an empty object for global state to overcome this.
๐ Bug fixes
Additional notes
Open source โโจ Features and improvements
- โ ๏ธ Change passing
global-stateto expression from theevaluatefunction to the constructor (#1267) - you can add an empty object for global state to overcome this.
๐ Bug fixes
- โ ๏ธ Change passing
- 23.3.017 May 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.2.3:
โจ Features and improvements
- Add new layer type: `color-relief (#1067)
๐ Bug fixes
- Add missing
global-stateexpression typing (#1130)
Additional notes
Open source โโจ Features and improvements
- Add new layer type: `color-relief (#1067)
๐ Bug fixes
- Add missing
global-stateexpression typing (#1130)
- 23.2.313 May 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.2.2:
โจ Features and improvements
- 23.2.230 Apr 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.2.1:
๐ Bug fixes
- Fix state validation - no error case (#1109)
- 23.2.123 Apr 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.2.0:
๐ Bug fixes
- Validate that
numberArrayandcolorArrayvalues are non-empty (#1094)
Additional notes
Open source โ๐ Bug fixes
- Validate that
numberArrayandcolorArrayvalues are non-empty (#1094)
- Validate that
- 23.2.022 Apr 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.1.0:
โจ Features and improvements
glyphsis now optional even if a symbol layer specifiestext-field; if it is unset,text-fontis interpreted as a fallback font list (#1068)hillshadelayer now supports multiple methods, and themultidirectionalmethod supports array values for illumination properties (#1088)- Add
global-stateexpression andstateroot property (#1044).
๐ Bug fixes
- Fix RuntimeError class, make it inherited from Error (#983)
- Validate that
layersarray items are objects instead of throwing an error if not (#1026) - Multiple fixes related to validating and parsing of strings containing object prototype keys
- Fix
validate_objectcrashing when object prototype keys used in style's objects (#1028) - Fix
validate_colorcrashing when object prototype keys used as color strings (#1036) - Fix color coercion in expressions (e.g.
to_color) producing invalid colors when object prototype keys used as color strings (#1036)
- Fix
Additional notes
Open source โโจ Features and improvements
glyphsis now optional even if a symbol layer specifiestext-field; if it is unset,text-fontis interpreted as a fallback font list (#1068)hillshadelayer now supports multiple methods, and themultidirectionalmethod supports array values for illumination properties (#1088)- Add
global-stateexpression andstateroot property (#1044).
๐ Bug fixes
- Fix RuntimeError class, make it inherited from Error (#983)
- Validate that
layersarray items are objects instead of throwing an error if not (#1026) - Multiple fixes related to validating and parsing of strings containing object prototype keys
- Fix
validate_objectcrashing when object prototype keys used in style's objects (#1028) - Fix
validate_colorcrashing when object prototype keys used as color strings (#1036) - Fix color coercion in expressions (e.g.
to_color) producing invalid colors when object prototype keys used as color strings (#1036)
- Fix
- 23.1.014 Jan 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v23.0.0:
โจ Features and improvements
- Add
vertical-alignoption toformatexpression (#832)
Additional notes
Open source โโจ Features and improvements
- Add
vertical-alignoption toformatexpression (#832)
- Add
- 23.0.012 Jan 2025
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v22.0.1:
โจ Features and improvements
- Adjust
geometry-typeexpression specification and MapLibre GL JS implementation to the historic behavior of only returningPoint,LineStringorPolygon, not theMulti...variants of these. This reverts a recent change to the implementation, which was causing issues in a large number of styles.
Additional notes
Open source โโจ Features and improvements
- Adjust
geometry-typeexpression specification and MapLibre GL JS implementation to the historic behavior of only returningPoint,LineStringorPolygon, not theMulti...variants of these. This reverts a recent change to the implementation, which was causing issues in a large number of styles.
- Adjust
- 22.0.128 Nov 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v22.0.0:
๐ Bug fixes
- Fix issue with
geomtry-typefilter (#924)
Additional notes
Open source โ๐ Bug fixes
Fix issue withThis was reverted in 23.0.0 due to causing issues in a large number of styles.geomtry-typefilter (#924)
- Fix issue with
- 22.0.017 Nov 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v21.2.0:
โจ Features and improvements
- 21.2.08 Nov 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v21.1.0:
โจ Features and improvements
Add
vertical-perspectiveprojection (#890)Additional notes
Open source โโจ Features and improvements
- Add
vertical-perspectiveprojection (#890)
- Add
- 21.1.031 Oct 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v21.0.0:
โจ Features and improvements
- Added
centerAltitudeproperty to stylesheet (#851)
Additional notes
Open source โโจ Features and improvements
- Added
centerAltitudeproperty to stylesheet (#851)
- Added
- 21.0.022 Oct 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.4.0:
โจ Features and improvements
Additional notes
Open source โโจ Features and improvements
Aligned the implementation ofThis was reverted in 23.0.0 due to causing issues in a large number of styles.["geometry-type"]with its spec. Now, when applicable,["geometry-type"]returns values not available while using"$type":"MultiPoint","MultiLineString", and"MultiPolygon". The behaviour of"$type"has not changed. (#519)
- 20.4.016 Oct 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.3.1:
โจ Features and improvements
- Added
rollproperty to stylesheet (#850)
Additional notes
Open source โโจ Features and improvements
- Added
rollproperty to stylesheet (#850)
- Added
- 20.3.117 Aug 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.3.0:
๐ Bug fixes
- The
index-of,length, andsliceexpression operators count a UTF-16 surrogate pair as a single character. (#779)
Additional notes
Open source โ๐ Bug fixes
- The
index-of,length, andsliceexpression operators count a UTF-16 surrogate pair as a single character. (#779)
- The
- 20.3.031 May 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.2.0:
โจ Features and improvements
- Added
Projectionspecifications #687 - Updated
Skyspecifications to support atmosphere and other required features #686
๐ Bug fixes
- Change
asserttowithin JSON modules. Requires Node.js 18.20.0 or later, and supports Node.js 22.0.0 or later - #675
Additional notes
Open source โโจ Features and improvements
- Added
Projectionspecifications #687 - Updated
Skyspecifications to support atmosphere and other required features #686
๐ Bug fixes
- Change
asserttowithin JSON modules. Requires Node.js 18.20.0 or later, and supports Node.js 22.0.0 or later - #675
- Added
- 20.2.04 May 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.1.1:
โจ Features and improvements
- Support
distanceexpression in web style spec - #642
Additional notes
Open source โโจ Features and improvements
- Support
distanceexpression in web style spec - #642
- Support
- 20.1.14 Feb 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.1.0:
๐ Bug fixes
- Add missing sky in diff results #518
- 20.1.011 Jan 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v20.0.0:
โจ Features and improvements
- Add
latest.jsonto dist folder to allow using the full version of the spec #490
Additional notes
Open source โโจ Features and improvements
- Add
latest.jsonto dist folder to allow using the full version of the spec #490
- Add
- 20.0.09 Jan 2024
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.3.3:
โจ Features and improvements
- Add back
migrate,validateandformatto the exported methods of this package #464 - Add terrain to diff method and improve type. This also removes the
operationsfrom the API #460 - Improve the type of
datain theGeoJSONSourceSpecificationfor TypeScript #463. - Add expression tests to this repo #476
- Add Sky spec, this is only the definition, no implementation at this point, only validation #478
๐ Bug fixes
- Fix queryRenderedFeatures Within a FeatureCollection of polygons #477
Additional notes
Open source โโจ Features and improvements
- Add back
migrate,validateandformatto the exported methods of this package #464 - Add terrain to diff method and improve type. This also removes the
operationsfrom the API #460 - Improve the type of
datain theGeoJSONSourceSpecificationfor TypeScript #463. - Add expression tests to this repo #476
- Add Sky spec, this is only the definition, no implementation at this point, only validation #478
๐ Bug fixes
- Fix queryRenderedFeatures Within a FeatureCollection of polygons #477
- Add back
- 19.3.320 Oct 2023
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.3.2:
- 19.3.227 Sept 2023
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.3.1:
- 19.3.113 Sept 2023
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.3.0:
- 19.3.019 Jul 2023
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.2.2:
โจ Features and improvements
- Add style property definition and validation for symbol layer
text-variable-anchor-offsetlayout property. #112
Additional notes
Open source โโจ Features and improvements
- Add style property definition and validation for symbol layer
text-variable-anchor-offsetlayout property. #112
- Add style property definition and validation for symbol layer
- 19.2.211 Jul 2023
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre Style Spec v19.2.1:
โจ Features and improvements
- Trim css color before parsing #255
- 19.2.126 May 2023
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre GL Style Spec v19.2.0:
โจ Features and improvements
- Skip running color match regex for hex color or rgb, if not required #186
Additional notes
Open source โโจ Features and improvements
- Skip running color match regex for hex color or rgb, if not required #186
- 19.2.022 May 2023
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre GL Style Spec v19.1.0:
โจ Features and improvements
- 19.1.030 Apr 2023
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre GL Style Spec v19.0.1:
โจ Features and improvements
- 19.0.117 Apr 2023
Release notes
Open source โhttps://github.com/maplibre/maplibre-gl-style-spec Changes since MapLibre GL Style Spec v19.0.0:
๐ Bug fixes
- Restore support for
Colorinstances inColor.parse#128
Additional notes
Open source โ๐ Bug fixes
- Restore support for
Colorinstances inColor.parse#128
- Restore support for
- 19.0.014 Apr 2023
Release notes
Open source โโจ Features and improvements Add support for defining colors using CSS Color 4 syntax https://github.com/maplibre/maplibre-style-spec/pull/94 ๐ Bug fixes Fix incorrect color interpolation in HCL and LAB color spaces when interpolation results are outside the sRGB gamut. https://github.com/maplibre/maplibre-style-spec/pull/94 Breaking changes Interpretation of interpolation of colors with alpha channel equal to 0 has changed. When interpolating colors with alpha channel equal to 0, the values of the other color channels in the specified color space are included in the calculation. Previously they were ignored and only the alpha value of the other, not fully transparent, color was interpolated. https://github.com/maplibre/maplibre-style-spec/pull/94
Additional notes
Open source โโจ Features and improvements
- Add support for defining colors using CSS Color 4 syntax #94
๐ Bug fixes
-
Fix color interpolation in HCL and LAB color spaces to use d50 white point instead of d65, in conformance with CSS spec #146
-
Fix incorrect color interpolation in HCL and LAB color spaces when interpolation results are outside the sRGB gamut. #94
Breaking changes
Interpretation of interpolation of colors with alpha channel equal to 0 has changed. When interpolating colors with alpha channel equal to 0, the values of the other color channels in the specified color space are included in the calculation. Previously they were ignored and only the alpha value of the other, not fully transparent, color was interpolated. #94
- 18.0.124 Feb 2023
Release notes
Open source โ/home/runner/work/maplibre-gl-style-spec/maplibre-gl-style-spec/release_notes.txt
- 18.0.1-pre.1523 Feb 2023pre-release
Nothing published for this version