Current release

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 session 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 account. 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.