intermediate
No code
Add a Mapbox Studio style as a basemap in ArcGIS Online
Prerequisite
Familiarity with and access to ArcGIS Online.

Mapbox allows you to integrate your Mapbox Studio styles with ArcGIS Online. In this tutorial, you’ll learn how to add a style from your Mapbox account to your ArcGIS Online project as a tile layer.

Getting Started

There are a few resources you will need in order to follow along with this tutorial:

  • ArcGIS Online account. You can sign up for a free account on the ArcGIS website.
  • Integration URL. You can find the integration URL in the Share & use modal for your style. Finding this will be covered in a later step.

Create a new project in ArcGIS

Navigate to your ArcGIS Online projects page and create a new project:

  • Log into ArcGIS Online.
  • Navigate to the Make a Map page. This will automatically create a new project.
  • Click Add > Add Layer from Web.

how to initialize adding a layer from web in ArcGIS

A new window will open. Choose A Tile Layer from the dropdown list.

how to specify a tile layer in ArcGIS

Find your ArcGIS integration URL

In another tab in your browser, open Mapbox Studio and find your ArcGIS integration URL:

  • Log into Mapbox Studio.
  • Navigate to your Styles page.
  • Click on the Share & use button next to the style you want to add to your map.
  • When the Share & use modal opens, switch to the Use tab.
  • Click the Third party option.
  • Toggle to ArcGIS.
  • Copy the URL by clicking the clipboard icon.

Screenshot showing the Share and use modal in Mapbox Studio

Add your Mapbox style as a tile layer

Let’s return to ArcGIS Online to finish adding our tile layer:

  • Navigate back to your ArcGIS Online project.
  • In the open Add Layer from Web window, paste your ArcGIS integration URL in the URL field.
  • Check the Use as Basemap box.
  • Add a Title to your layer.
  • Add “© OpenStreetMap contributors Design © Mapbox” to the Credits field.
  • Click Add Layer.

complete add layer from web form in ArcGIS

Finished product

Congratulations! You’ve successfully added your Mapbox style as the basemap in your ArcGIS Online project.

Next steps

If you’re interested in creating a custom or branded style in Mapbox Studio to be used in ArcGIS Online, take a look at our Create a custom style tutorial.