beginner
No code
Integrate Mapbox with Tableau

You can integrate you Mapbox maps with business intelligence tools like Tableau. This tutorial walks you through adding your Mapbox style to your Tableau visualization.

Tableau with mapbox map

Getting started

Maps styled with the Mapbox Studio style editor or Mapbox Studio Classic can be added to Tableau 10.2.2 as background maps. To complete this tutorial, make sure you have the latest version of Tableau (10.2.2 or higher). If you are using a version lower than Tableau 10.2.2, please refer to this section. Additionally, you will need a map style created with the Mapbox Studio style editor.

Add a map made with Mapbox Studio

In Tableau, click Map > Background Maps > Map Services to open the Map Services dialog box.

Tableau map serivces menu item

In the dialog box, click Add > Mapbox Maps

Tableau map services dialog box

In Mapbox Studio, navigate to the Styles page, click on the style you would like to add to Tableau, then click the Share, develop & use link on the right side of the page.

Mapbox studio style info page

From the Use style in GIS apps menu, click on the Tableau button, then click the clipboard icon to copy the Tableau integration URL to your clipboard.

Mapbox studio style share page

Back in Tableau, give your style a name in the Style Name field (this can be whatever you like), then paste the Integration URL you copied in the previous step into the Url field. The API access token, Username, and Layer ID fields will be populated automatically. Click OK.

Tableau add mapbox map dialog box

Add a map made with Mapbox Studio Classic

In Tableau, click Map > Background Maps > Map Services to open the Map Services dialog box.

Tableau map services menu

In the dialog box, click Add > Mapbox Maps

Tableau map services dialog box

In the next dialog box, select the Classic tab, then choose a style name (this can be whatever you like) and enter your access token in the API access token field. You can choose to use a preset style or use a map from your Mapbox account.

To use a preset Style, choose one of the options available in the Mapbox preset style dropdown and click OK.

Tableau add classic mapbox map dialog

To add a custom style, click the Custom (with one or more layers) radio button in the Add Mapbox Map dialog box, enter one or more Classic map IDs, then click OK.

Tableau add classic map dialog, completely filled out

Access maps

You can access the Mapbox maps you’ve added to Tableau by clicking Map in the menu bar, then selecting Background Maps.

Tableau background maps menu

Troubleshooting

Changes to your styles are not appearing in Tableau

If changes made in the Mapbox Studio style editor or Mapbox Studio Classic are not being updated in Tableau, try clearing the desktop cache in Tableau.

  • On Windows, delete everything in the MapTiles folder usually found at C:\Users\your-username\AppData\Local\Tableau\Caching\ExternalCacheV1\MapTiles
  • On Mac, delete everything in the MapTiles folder usually found at /Users/your-username/Library/Caches/com.Tableau.caching/ExternalCacheV1/MapTiles

Mission accomplished

Tableau with mapbox map

Now that you’ve added your map to your Tableau workbook, the rest is up to you! You can modify your map style in Mapbox Studio and your changes will be reflected in your Tableau workbook the next time you open it. For more information, visit Tableau’s help page for adding and managing map layers.