---
title: "How to add maps to Tableau | Guides | Maps apis | Maps platform"
description: "Step-by-step guide to adding MapTiler maps into Tableau."
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# How to add maps to Tableau

This article shows how to add any map from MapTiler into Tableau:

## Get a Tableau TMS file from MapTiler

First login to your MapTiler account and go to the [maps page](https://cloud.maptiler.com/maps/).

![StandardMaps.png](./StandardMaps_f205e43546.webp)

Click on the map style that you want to add to Tableau, it could be one of our standard maps or one of your own creations.

Scroll down to the bottom of the options for the map style to find the Download TMS button. 

![CloudTMS.png](./CloudTMS_90b50ce0dd.webp)

The TMS file contains instructions for Tableau to access your MapTiler Account with your API Key.  
**Keep your TMS files secure and don’t share them as they contain your API Key.**They will be saved in the same location as your regular browser downloads.

## Import your map into Tableau

To import maps from MapTiler to Tableau we recommend using one of the [**Tableau templates**](https://help.tableau.com/current/pro/desktop/en-us/buildexamples_maps.htm) with **imported maps**, for example, the Regional project template.

![tableau\_screen\_templates.png](./14246430458001_eafac9bfae.png)

Tableau has a feature that prevents users from making charts without the correct type of data.

Therefore your data **needs to have a** **geographical element** to be able to add a map.  
If your data has a **zip code** or **X and Y coordinate columns** you can designate these as geographical and then add a map. However, it is easier to use an existing project though as it is not always that easy to get coordinates work!

When you have opened Tableau and chosen your project template, click on the window with the original map and you can import the TMS file here:  _Map_ -> _Background Maps_ -> _Manage Maps…_

![](./file_e54d30070e.webp)

Click on the _Import…_ button

![](./file_ba36bf5ead.webp)

Import your TMS file and enjoy the beautiful map from your MapTiler account!

![](./file_ba26b3602a.webp)

Want to add maps from MapTiler Server? Read this: [On-premise Tableau maps](https://docs.maptiler.com/guides/self-hosting/map-server/on-premise-tableau-maps)

## Useful links

[On-premise Tableau maps](https://docs.maptiler.com/guides/self-hosting/map-server/on-premise-tableau-maps)  
[How to upload map style to MapTiler](https://docs.maptiler.com/guides/map-design/how-to-upload-map-style-to-maptiler-cloud)