Add a Mapbox style to a CARTO map

Maps styles created with the Mapbox Studio style editor or Studio Classic can be added as basemaps to CARTO. Any of the preset basemaps or a custom style from Mapbox can be added as the primary basemap for your CARTO map.

Getting started

For this guide, you'll need a Mapbox account and a CARTO account. Log in to each, then head on to the next steps.

Open the CARTO project where you would like to add your Mapbox style. Click on the pencil icon and click on the current BASEMAP that is listed.

Under Style, click the + .

Add style created with Studio

In Mapbox Studio, click the Share & use button next to the style you would like to add to your CARTO project.

When the Share & use modal opens, switch to the Use tab. Click the Third party option, and toggle to CARTO. Copy the URL by clicking the clipboard icon.

Back in CARTO, paste the Share URL you copied in the previous step into the text box, then click on ADD BASEMAP.

The Studio style you added will appear as the CARTO basemap.

Add style created with Studio Classic

In Mapbox Studio, visit the Classic page at mapbox.com/studio/classic . Find the style you would like to use, then click on the clipboard icon to copy the style's tileset ID to your clipboard.

Head back to your CARTO project, where the "Change basemap" dialog should still be open. Click on the Mapbox tab, and paste the tileset ID you copied to your clipboard in the previous step into the "Enter Your Map ID/URL" text box. You will also need to paste a valid access token into the "Enter Your Access Token" text box. To finish adding your Mapbox basemap, click on ADD BASEMAP.

The Mapbox Studio Classic style you added will appear as the CARTO basemap.

Finished product

You added styles created in both Mapbox Studio and Mapbox Studio Classic to a map in CARTO!