Add Mapbox map styles as basemaps in ArcGIS Online

Last Published: April 25, 2020


Basemaps from other sources such as Mapbox can be added to ArcGIS Online. MapBox contains multiple map style options that can be used to create customized basemaps as a reference to the map layer. Map styles from Mapbox can also be added as a Web Map Tile Service (WMTS) to ArcGIS Online.

Mapbox is an open source mapping platform for mobile and web applications. To browse the collection of maps in the application, create and sign in to the Mapbox account.


To add a Mapbox map style as a basemap in ArcGIS Online, create the basemap in Mapbox, and add the basemap to ArcGIS Online.

Mapbox is a third-party product and may consume credits. Esri is not responsible for positioning inaccuracies, subsequent updates, errors, or omissions of data.

In the Mapbox website

  1. On the Mapbox Gallery page, select the desired basemap style, and click Learn More. In this example, the Decimal map is used.
Desired basemap
  1. Click Add Decimal to your account to add the map style to the Mapbox account.
Add decimal to your account option
  1. In the Mapbox Studio style editor, click Share to open the Share dialog box.
Share option
  1. Click Third party under the Developer resources section, and select WMTS from the drop-down list.
  2. Click the Copy icon Copy icon at the end of the Integration URL field to copy the integration URL.
Developer Resources section

In ArcGIS Online

  1. Log in to ArcGIS Online, and navigate to Map.
  2. Click the Add drop-down list, and select Add Layer from Web.
Add drop-down
  1. In the Add Layer from web dialog box, do the following:
    1. For What type of data are you referencing?, select A WMTS OGC Web Service.
    2. Paste the integration URL copied in step 5 of the Mapbox workflow above, and click GET LAYERS.
    3. Check the Use as Basemap check box under Layer and, click ADD LAYER.
Add Layer from Web dialog box

The image below shows the Map Viewer with the Mapbox map as the basemap.

MapBox map as basemap

Article ID:000022021

  • ArcGIS Online

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options

Related Information

Discover more on this topic