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 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 > Map Services.

  2. In the Map Services dialog box, select Add > Mapbox Map.

  3. 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>

      When you add the correct style URL to this field, the API access token, Username, and Layer ID fields automatically populate.

    • If you don't have a style URL for the Mapbox map, you must enter a Mapbox access token, username, and layer (map) ID to add your Mapbox map.

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

  4. 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

By default, all map layers appear in the view when you first add a Mapbox map to a workbook.

Map layers are different from data layers in Tableau. Data Layers are pre-built tiles that include demographic information by various levels, like State, County, and Block Group. 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.

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.