intermediate
No code
Add Mapbox maps as layers in ArcGIS and QGIS with WMTS
Prerequisite
Familiarity with and access to ArcGIS.

Mapbox provides a number of handy, pre-built URLs and code snippets to help you add your custom Mapbox maps to other mapping tools. This tutorial will show you how you can add any Mapbox map as a layer in ArcMap or QGIS as WMTS.

Getting started

Before diving in, make sure you have the following ready to go:

  • A Mapbox account. If you haven’t done so already, sign up for a Mapbox account.
  • ArcMap or QGIS installed on your computer. You should be somewhat familiar with your mapping software’s interface before starting this tutorial.
  • A Mapbox style. Head to your style page in Mapbox studio to see a list of the styles in your account.

Add Mapbox maps in ArcMap

Both ArcMap and QGIS can read map tiles protocol, which is what you’ll use to add your Mapbox styles. To get started in ArcMap:

  1. Click the Add Data button in the toolbar to open the Add Data dialog box.
  2. At the top of the dialog box, click the arrow next to Look in: and select GIS Servers.

    arcmap add data dialog

  3. Double-click Add WMTS Server to open the Add WMTS Server dialog box.

    arcmap add wmts server dialog

  4. Head to the share page for the Mapbox style you would like to add to ArcMap, then scroll to the bottom of the page and copy the WMTS endpoint: URL to your clipboard.
  5. In the URL field at the top, add the URL you copied in the previous step.
  6. In the Server Layers section, click Get Layers. When prompted for a username and password, click Cancel. You may have to click it several times to dismiss the box.

    arcmap add GIS server connection

  7. When the layers are loaded in the window, click OK.

    arcmap add wmts server confirmation dialog

  8. You should see Mapbox on api.mapbox.com in the Add Data dialog box. Double click it, select the name of your style in the next dialog box, then click Add.

    mapbox style in arcmap map preview window

You should see your map as a layer inside your ArcMap document. Note that each style will have to be added individually.

Add Mapbox maps in QGIS

Similarly, QGIS can read map tiles from a WMTS server. To add your Mapbox map to QGIS:

  1. In QGIS, click the Add WMS/WMTS button.

    qgis add layers from wmts server dialog

  2. Make sure the Layers tab is selected in the dialog box. Below the dropdown menu at the top of the box, click New.
  3. Head to the share page for the Mapbox style you would like to add to ArcMap, then scroll to the bottom of the page, click the QGIS toggle, and copy the WMTS endpoint: URL to your clipboard.
  4. Give the layer a name and add the URL you copied in the previous step. Press OK.

    qgis create a new WMS connection dialog

  5. Back in the Add Layer(s) from a WM(T)S Server dialog box, the name of your layer should appear in the box at the top. When you see this, click Connect.

    qgis layer confirmation dialog

  6. The Tilesets tab should open with a single layer. Select that layer and click Add, then click Close to close the dialog box.

    completed qgis map with Mapbox style

You should see your map as a layer inside your QGIS document. Note that any style you would like to visualize will have to be added individually.

Finished product

Congratulations! You used WMTS to add a Mapbox style to ArcMap and QGIS.