Unable to Display Some Background Map Layers in custom Mapbox Maps After Upgrading

Published: 30 Aug 2019
Last Modified Date: 30 Aug 2019


When a visualization uses a custom Mapbox map, some zoom-dependent background map layers that displayed on raster / vector maps (Tableau Desktop or Tableau Server 2019.1 and earlier) might not display in Tableau Desktop 2019.2, Tableau Server 2019.2, or Tableau Online.


  • Tableau Desktop 2019.2
  • Tableau Server 2019.2 
  • Tableau Online 


  • If the workbook contains one map with this issue, edit the workbook to zoom in/out until the missing background layer appears.
  • If the layer is missing on many maps that use the same custom Mapbox map, sign into Mapbox Studio and adjust the zoom levels for that background layer.


Tableau 2019.2 and later uses vector maps and supports continuous zooming. In previous versions of Tableau that used raster maps, tiles and zoom levels were rounded at quarter intervals.

These zoom levels determine when certain background layers display on a map. When a map is upgraded from a raster to a vector map, background layers that used to display at certain zoom levels may disappear from the upgraded map, since zooming is more precise and no longer rounded.
Did this article resolve the issue?