Current release

Release Notes (2.14.0) : Released 17th September 2026

• Updates to the United States Worldview.

---

Release Notes (2.13.0) : Released 27th August 2026

• Text in error response JSON message and details has been updated.

---

Release Notes (2.12.0) : Released 15th January 2026

• Added group to self endpoint response. This property describes basemap styles that have a similar purpose.

---

Release Notes (2.11.0) : Released 14th October 2025

• Added language support to the following Open Basemap styles:
  • open/blueprint
  • open/dark-gray
  • open/dark-gray/labels
  • open/hybrid
  • open/hybrid/detail
  • open/light-gray
  • open/light-gray/labels
  • open/navigation
  • open/navigation-dark
  • open/osm-style
  • open/osm-style-relief
  • open/osm-style-relief/base
  • open/streets
  • open/streets-night
  • open/streets-relief
  • open/streets-relief/base
• Improved the handling of different sources in custom styles.

---

Release Notes (2.10.0) : Released 2nd September 2025

• Added support for Basemap Sessions. A basemap sessionA basemap session is a timeframe during which a single user of a single application can use a session token to access unlimited basemap tiles from the Basemap Styles service. It is created a session starts and valid for a maximum duration of 12 hours.Learn more permits requests for basemap tiles for a maximum duration of 12 hours. This usage model is available for developers that have an ArcGIS Location Platform accountAn ArcGIS Location Platform account, formerly known as an ArcGIS Developer account, is an identity associated with an ArcGIS Location Platform subscription.Learn more. For more information see Basemap usage.
• Added a new query parameter echoToken to webmaps and styles endpoints. This parameter controls whether the token is embedded in URLs for style resources such as tiles and fonts.

---

Release Notes (2.9.0) : Released 24th July 2025

• Added worldview support to the arcgis/streets-relief and arcgis/streets-relief/base styles.

---

Release Notes (2.8.0) : Released 23rd June 2025

• Added styleFamily to self endpoint response – groups Basemap Styles by style family (ArcGIS or Open) – can now be used to group styles in applications using the self describing endpoints.

---

Release Notes (2.7.0) : Released 29th May 2025

• Open Street Maps styles marked as deprecated.
• Open Basemap styles added:
  • open/blueprint
  • open/dark-gray
  • open/dark-gray/base
  • open/dark-gray/labels
  • open/hybrid
  • open/hybrid/detail
  • open/light-gray
  • open/light-gray/base
  • open/light-gray/labels
  • open/navigation
  • open/navigation-dark
  • open/streets
  • open/streets-night
  • open/streets-relief
  • open/streets-relief/base
  • open/osm-style
  • open/osm-style-relief
  • open/osm-style-relief/base

---

Release Notes (2.6.0) : Released 28th February 2025

• Added support for a US Edition of basemap styles. Added unitedStatesOfAmerica to the list of available Worldviews. This option is available for existing basemap styles that support the worldview query parameter.
• Resolved a bug with worldview for ArcGIS Light-Gray/Dark Gray and Human Geography Labels layers.

---

Release Notes (2.5.0) : Released 10th February 2025

• Added support for 'no' language code for Norway.

---

Release Notes (2.4.0) : Released 13th June 2024

• The following styles now support the places parameter:
  • arcgis/imagery
  • arcgis/imagery/labels
  • arcgis/streets
  • arcgis/streets-night

---

Release Notes (2.3.0) : Released 6th March 2024

• The worldview query parameter is no longer in beta - see API reference. This parameter allows you to control the display of disputed borders and labels for specific countries, for key ArcGIS styles. To learn more, see this page.
• The places query parameter is no longer in beta - see API reference. This option allows you to control the display of places, or points of interest, on arcgis/navigation and arcgis/navigation-dark styles. With the attributed option, you can also fetch additional details about a place or point of interest. To learn more about this workflow, see this page.
• Using a style with places=attributed is now rendered correctly with MapLibre.
• The self describing endpoints now include details of supported places and worldview options for a given style.
• Duplicate query parameters are now rejected to avoid ambiguity of requests.

---

Release Notes (2.2.0) : Released 10th November 2023

Includes the following new features:

Beta

• A places query parameter that allows you to display places with arcgis/navigation and arcgis/navigation-dark styles.
• A worldview query parameter that allows you to display worldview borders and labels for specific countries using some ArcGIS styles.

NOTE: These are beta features with some limitations. To ask questions or provide feedback, please go to the Early Adopter Community.

Release

• The basemap styles service will now enforce that your token or API key has the premium:user:basemaps privilege (available for all keys by default).

• Added OpenAPI Specification endpoints. This gives developers access to the yaml description of the API.

• Added new endpoints that describe the service capabilities in JSON, which allows the user to build dynamic UI apps such as a basemap picker.

  • arcgis/rest/services/styles/v2/self
  • arcgis/rest/services/styles/v2/webmaps/self
  • arcgis/rest/services/styles/v2/styles/self

• Addressed problem with Access-Control-Headers when making a preflight header request.

• Fixed issue with the display of Arabic labels for osm/light-gray and osm/dark-dray styles.

• Improved language code fallback for unsupported languages - for example using fr-CA will now result in fr.

• Return more informative response messages when a given item id does not correspond to a style.

• HTTP response headers now contain cache control values. These allow clients to keep their cached responses for a sensible amount of time.

---

Release Notes (2.1.0) : Released August 2023

The basemap styles service (v2) includes several improvements to the basemap styles service (v1).

This includes the following:

• New service URL endpoints to return map styles according to the Mapbox Style Specification or the Esri Web Map Specification.

• New ArcGIS and OSM map styles:

  • Outdoor
  • Human geography
  • OSM blueprint
  • OSM hybrid
  • OSM navigation
  • OSM navigation (night)

• Extended language support for place labels and local language support options.

• API key support and HTTP header authentication.

• Open API specification compliant.

• Error response that use standard HTTP status codes (e.g. 400 or 401) rather than 200.