beginner
No code
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.

Carto change basemap dialog

Under Style, click the + .

Add a style in Carto

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.

Mapbox style share and use modal

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.

Mapbox style Use modal carto item

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

carto add basemap dialog

The Studio style you’ve just 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 Map 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 Map 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.

carto add mapbox map dialog

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

Finished product

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