Continue in the app
Be The First To Get Support Updates
Want to know about the latest technical content and software updates?

How To: Add Mapbox map styles as basemaps in ArcGIS Online


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

Related Information

Last Published: 12/16/2019

Article ID: 000022021