Use Mapbox Maps

If you have access to Mapbox maps, you can add them to your workbooks or use them to create map views in Tableau Desktop. Fora list of country-specific data available, see Supported Map Data.

When you publish a view that uses Mapbox maps to Tableau Server, Tableau Online, or Tableau Public, your audience can view your data and your Mapbox map without having a Mapbox account.

Starting in Tableau Desktop 2019.2, Mapbox styles Streets, Outdoors, and Satellite are available by default in Tableau in the Map Layers pane. For more information on map styles and map layers, see Customize How Your Map Looks.

Add a Mapbox map to your workbook

In Tableau Desktop, you can add a Mapbox map to your workbook and use it as a background map.

After you add a Mapbox map to your workbook, the map is saved with the workbook and available to anyone with whom you share the workbook. You can also save a Mapbox map as a Tableau Map Source (.tms) file that you can share with others so they can quickly connect to it and use it in their own workbooks. For more information, see Save a Map Source . To add a Mapbox map:

  1. In Tableau Desktop, select Map > Background Maps >Mapbox Map.

  2. In the Add Mapbox Map dialog box, add:

    • Style name: enter a name for the Mapbox map. This name can be anything you want, and will appear in the Background maps menu after you add the map.

    • Url: enter a style URL for the Mapbox map you want to add.

      This URL contains the style ID for your Mapbox map, your access token, and your username. It might look similar to the following:<username>/<styleid>?access_token=<access token>

    For more information about any of the above items, see the Access Tokens, Maps, and Styles sections of the Mapbox API Help.

  3. When finished, click OK to exit the Add Mapbox Map dialog box, and then click Close to return to the view.

Create a map view using a Mapbox map

To create a map view using a Mapbox map, select Map > Background Maps, and then select the Mapbox map you want to use. Next, build the map view. For information, see Mapping Concepts in Tableau.

Add or subtract map layers from the view

When you add a Mapbox Studio map to Tableau, all the map's layers are added, too. Layer groups and single layers in Mapbox Studio will display as individual layers in the Map Layers Pane in Tableau, and will retain the layer configuration set in Mapbox Studio.

If a layer group in Mapbox Studio includes sublayers that are turned off, those sublayers will also be turned off when the map is added to Tableau, and the layer group will appear as a single layer in the Map Layers pane. If the layer group is turned off in Tableau, then back on, all of that layer group's sublayers will be turned on.

Map layers are different from data layers in Tableau. In Tableau, Data Layers are pre-built tiles that include demographic information by various levels, like State and County. Data layers and Mapbox are independent of one another in Tableau. For more information about how data layers work, see Customize How Your Map Looks.

Note: When you add custom map from Mapbox Studio into Tableau, the data for all layers are imported, even if those layers are turned off. Your map's performance could be affected if it includes many layers and sublayers. To improve performance, add or remove layers and sublayers in Mapbox Studio before adding your map to Tableau.

See also:

Use Web Map Service (WMS) Servers

Save a Map Source

Import a Map Source

Select Background Maps

Customize How Your Map Looks


Thanks for your feedback! There was an error submitting your feedback. Try again or send us a message.