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


It is possible to import custom basemaps from other sources such as Mapbox in ArcGIS Pro. Integrating Mapbox map styles in ArcGIS Pro projects can provide highly customizable and design-oriented basemaps as a reference to the map layer.

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.


Use the workflows below to add a Mapbox map style as a basemap in ArcGIS Pro:

In the Mapbox website

  1. On the Mapbox Gallery page, select the desired basemap style (for example, Pencil), and click Learn more.
The Mapbox Gallery page
  1. Click Add Pencil to your account to add the map style to the Mapbox account.
Add the map style to the Mapbox account
  1. In the Mapbox Studio style editor, click Share to open the Share dialog box.
Share the map style
  1. Click Third party under the Develop section, and select WMTS from the drop-down list.
  2. Click the Copy icon The Copy icon at the end of the Integration URL field to copy the integration URL.
Copy the map style URL

In ArcGIS Pro

  1. Open the desired project.
  2. On the View tab, click the Catalog View icon in the Windows group to activate the Catalog tab.
The Catalog tab
  1. In the Create group of the Catalog tab, click New > New WMTS Server.
Click the New WMTS Server
  1. In the Add WMTS Server Connection dialog box, for Server URL, paste the integration URL copied in step 5 of the above workflow, and click OK.
The Add WMTS Server Connection dialog box

The Pencil map style appears in the Catalog pane. Expand Servers > Mapbox on api.mapbox.com.wmts > Mapbox > Pencil. Add the map style by dragging and dropping it in onto the map view or in the Contents pane.

The Pencil map style appear in the map

Related Information

Last Published: 10/23/2019

Article ID: 000021947

Software: ArcGIS Pro 2.4.2, 2.4.1, 2.4, 2.3.3, 2.3.2, 2.3.1, 2.3, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2