Loading

How to Specify the Layer to be Initially Displayed When Using WMS Map in Tableau Desktop

Publish Date: Mar 18, 2026
Task

When initially displaying WMS map, the top layer of the map layer is selected by default. Is it possible to set the layer for the initial display?

Steps

Tableau Desktop 2022.2 or later 

  1. Select Map > Background Layers.
  2. Select the WMS map layer you want to use.
  3. Select Make Default.
    User-added image
  4. Select Map > Background Maps > Set As Default.
User-added image
The above operation will ensure that the selected layer will be displayed the next time you open Tableau Desktop.
*This operation creates a tms file with the settings saved in the "Mapsources" folder in My Tableau Repository.

Tableau Desktop 2022.1 or earlier

Although it is not possible to perform the same steps in earlier versions of Tableau Desktop the update can be accomplished by using a similar TMS file created with Tableau Desktop 2022.2 or later.

Note: While a .tms file may be helpful in connecting to your map server, Tableau does not test or support .tms files, and success may vary. 
Additional Resources
See Creating a Custom Map Connection for details.
Knowledge Article Number

001468893

 
Loading
Salesforce Help | Article