The out-of-the-box Tableau symbol and filled maps are some of the most powerful visualization types available in the software. This is because maps provide a means of decoding hundreds of latitude/longitude pairs almost instantly—all with a single image. Not only that, Tableau does a lot of the heavy lifting for us by providing the geographic coordinates of locations all over the world—this way we get to enjoy making maps instead of looking up longitudes and latitudes. Maps in Tableau are continuously improving as new mapping features are introduced with every major release. But wait—there’s more! You can create custom maps in Tableau for just about anything. This tutorial will walk you through how to map any background image in Tableau.

Watch the Related Video with Playfair+


Why you can map anything in Tableau

Tableau maps are technically scatter plots on top of a background image. Tableau will plot a point at each combination of the latitude on the Y-axis and longitude on the X-axis. To help illustrate the scatter plot concept, take a look at the following two images. First, the latitude and longitude plotted with no background image:


And here, the same data points plotted with a background image of the United States:


Due to the way maps function in Tableau, as long as you know the coordinates of a point on the vertical Y-axis and horizontal X-axis, you can map anything you would like! This provides some unique possibilities. So let’s build one of these. For this tutorial, I will use this image of a baseball diamond:

Baseball Diamond for Custom Tableau Background Image

Let’s imagine that we want to visualize different baseball statistics by player position. To create this visualization, we first need to plot the nine positions on the field.


How to map custom background images in Tableau

Locate image and image dimensions

First we will need an image. If you want to follow along, download an image of a baseball diamond. For best results, pre-size the image in the desired dimensions and take note of the height and width of the image in pixels. The baseball diamond image just shown is 500 pixels wide by 500 pixels high.

Expert Analytics Team
Staff Augmentation

Make our award-winning team your award-winning team.

Create dataset with fields for X and Y coordinates.

The next step is to create a dataset that has at least three fields: (1) Each point you want to plot (in our case it’s player position), (2) X Position, and (3) Y Position.

For the first row, just put an arbitrary name in the cell for the point you want to plot, such as “Lookup”. The X value will be the width of the image, and the Y value will be the height of the image. At this point, my dataset looks like this (the player position coordinates still need to be looked up):

Excel Data to Map a Custom Tableau Background Image with Lookup Row


Adding a background image

Start a new workbook in Tableau and connect to the data from the previous step. Navigate to Map > Background Images, and click on the data source. This will open a new dialog box where you can choose “Add Image” in the lower-left corner. This is where you can choose which image will act as the background. If you’re following along with the baseball example, navigate to the image that you downloaded earlier.

All that is left in this step is to put the maximum value for the X and Y coordinates. If our image is 500 wide by 500 high, we would make the following entries:

X Position: 0 Left, 500 Right
Y Position: 0 Bottom, 500 Top

Also be sure to change the “Y Field” from “X” to “Y”. At this point, your screen should look like this:

Image Dialog Box in Tableau

Click OK to apply your changes.


Looking up X / Y coordinates to map a background image in Tableau

Start your new custom map by placing the X measure on Columns Shelf and the Y measure on the Rows Shelf. Ensure both axes are fixed at the maximum X and Y values; which are 500 for both in our case. If you need to change an axis, simply right click on the axis, choose “Edit Axis”, and fix the range at 0 to 500.

In order to look up the X and Y coordinates for each position player (or whatever you are plotting), right click on the view, hover over “Annotate”, and click “Point”. If the X and Y measures are the only fields on your view, the annotation will show you the X and Y values by default. This is what we want, but you may want to make the font larger so that it’s easier to read.

Now drag the end point of the annotation to each location you want to plot, and see how the X and Y values change. For best results, format the annotation so the line end is a circle; this way you can precisely drag the circle to the exact location you want plotted. Here is one example showing the coordinates for the Catcher:

Plotting X and Y Positions in Tableau

Drag the annotation to each point you want to plot and record the coordinates in your dataset. Note that you don’t need to record the decimals. Here is a look at my data with the X and Y coordinates for each player position:

Complete Excel Data


Refresh your map

After all coordinates have been recorded in your dataset, save your data and refresh the data source in Tableau.

Drag the field you are plotting, such as position in the baseball example, to the Detail Marks Card. You should now see a circle at each position, like this:

Custom Background Image in Tableau After Refreshing Data


Finalizing the custom view

There are a few items you can do to finalize your custom Tableau map:

– Remove the annotation by right-clicking on it and selecting “Remove”.

– Hide the axes by right-clicking on each one and deselecting “Show Header”.

– Format your marks; my favorite is a filled circle with a custom color and white border.

– Filter out the “Lookup” X and Y coordinates. You will notice a mark in the upper-right corner of your new custom map. You can filter this out by either right-clicking on it and choosing “Exclude”, or for better long-term results, remove this row from your underlying data and refresh your view.

Receive More Free Tips & Tricks Like This Every Week

Let’s stay in touch:


– Optional: You can now add measures to your underlying data for each position to visualize different metrics on your customized view (i.e., size the circles by fielding %).

The final custom Tableau map will look like this:

Final Custom Background Image in Tableau

Thanks for reading,
– Ryan


This content is excerpted from my book Practical Tableau: 100 Tips, Tutorials, and Strategies from a Tableau Zen Master published by O’Reilly Media Inc., 2018, ISBN: 978-1491977316. Get the book at Amazon.

Become a member

Get access to this related video & more!

Become a Member

Related Content

Ryan Sleeper

Create and Encode Custom Shapes Using Any Image We’ll have some fun mapping custom polygons on a baseball stadium. You’ll…