How Do You Add Icons to Tableau?

Tableau ships with a small set of built-in shapes, and the moment you try to build anything that looks like a real product you run out of them. You want a tick and a cross, not circle and square. You want your own brand marks, a set of weather icons, or a row of little flags.

The good news is that Tableau was designed for this. Custom icons are not a hack or a workaround — there is a dedicated folder for them, Tableau reads it on startup, and the icons you add travel with the workbook when you share it.

The slightly annoying news is that the process involves a folder on your hard drive rather than a button inside the application, which is why so many people assume it is not possible. This guide covers the built-in shapes, how to add your own, how to size them so they do not look terrible, and the one mistake that makes your icons vanish for everyone else who opens the workbook.

What is the fastest way to add icons to Tableau?

Drag a dimension onto Shape on the Marks card. Tableau immediately assigns a different built-in icon to every member of that field.

That is the whole answer for built-in shapes, and it is where most people should start. Tableau's own documentation describes the behaviour plainly: "When you place a dimension on Shape on the Marks card, Tableau separates the marks according to the members in the dimension, and assigns a unique shape to each member."

To use icons that Tableau does not ship with, you add image files to a folder on disk:

1. Open My Tableau Repository in your Documents folder.
2. Open the Shapes folder inside it.
3. Create a new folder and give it the name you want the palette to have.
4. Copy your icon files into that new folder.
5. Restart Tableau, or click Reload Shapes in the Edit Shape dialog.

Your folder name becomes the palette name in the shape picker. That is the whole mechanism — a folder is a palette, and the files inside it are the shapes.

It is worth being clear about which problem you are actually solving before you start making files. If you only need marks that are visually distinct from one another, the built-in shapes already do that and you are finished. Custom icons are for when the shape has to mean something specific — your brand, a status, a real-world object the reader will recognise instantly.

Not sure which visuals are actually earning attention on your site? Get a free SEO audit and see which pages your audience reaches first.

How does Tableau's Shape mark actually work?

Shape is one of the mark properties, in the same family as Color and Size. It takes a field and splits the marks in your view by that field's members, giving each one a distinct visual token.

The ten-shape ceiling

By default Tableau has ten unique shapes available for encoding a dimension. If your field has more than ten members, the shapes start repeating, and two different categories end up wearing the same icon.

That is the point at which a shape encoding stops communicating anything. If you have fifteen product lines, shape is the wrong channel for them — and adding fifteen custom icons will not fix it, because fifteen small marks are not distinguishable at a glance regardless of how pretty they are.

Shape is a categorical channel, not a quantitative one

Size and Color can carry magnitude. A bigger circle means more, a darker blue means more. Shape cannot do that. A triangle is not "more" than a square.

So shape belongs on fields where the members are genuinely different kinds of things: pass and fail, the four regions, the three channels. Use it for identity, and leave magnitude to size and colour.

This is also why shape and the mark type are easy to confuse. Changing the mark type to Shape tells Tableau to draw each data point as an icon. Dropping a field on the Shape card tells Tableau which icon each point gets. You need both: the mark type makes icons possible, and the field makes them meaningful.

The Edit Shape dialog

Clicking the Shape card opens the Edit Shape dialog. On the left is the list of members in your field, on the right is the palette of available shapes, and above the palette is a dropdown listing every palette Tableau can find.

Two buttons in that dialog matter more than they look. Assign Palette maps the whole palette to your members in one click rather than making you set each one. Reload Shapes re-reads the Shapes folder from disk without restarting Tableau.

There is also a Reset button, which throws away your manual assignments and returns the field to Tableau's defaults. It is the fastest way out of a view where you have assigned icons by hand, lost track of which member has which, and want to start again.

How do you add your own custom icons to Tableau?

Step 1 — find your repository

My Tableau Repository is created automatically in your Documents folder when you install Tableau. Inside it you will find folders for Workbooks, Data Sources, Bookmarks and Shapes.

If you have moved your repository, or you work on a managed machine where Documents is redirected, you can check the current location at File > Repository Location. Worth knowing: changing the repository location does not move the files contained in the original repository, so your old shapes stay where they were.

Step 2 — make a folder for your palette

Inside the Shapes folder, create a new folder. Tableau's instruction is exactly that: "Copy the shape files to a new folder in the My Tableau Repository\Shapes folder in your Documents folder."

Name the folder something you will recognise in a dropdown six months from now. "Company Icons" is better than "new shapes 2". The folder name is the palette name, and you cannot rename it from inside Tableau.

Step 3 — prepare the image files

Tableau accepts a specific list of formats for shape files: .png, .gif, .jpg, .bmp and .tiff.

In practice you want PNG. Tableau's documentation recommends a transparent background so that Tableau can colour the shape, and both GIF and PNG support transparency — PNG does it better, with soft edges rather than a single hard cut-out colour.

Size matters more than people expect. The guidance from Tableau is specific: "Unless you plan on using Size to make the shapes really large, you should try to make your original shape size close to 32 pixels by 32 pixels." Icons much larger than that get scaled down and often come out muddy; icons much smaller get scaled up and come out soft.

One file is one shape. If you want a set of five icons, that is five files in one folder, not a sprite sheet.

Step 4 — load them

If Tableau was closed, it picks up the new palette the next time it opens. If Tableau is already running, the documentation is explicit: "If you modified the shapes while Tableau was running, you may need to click Reload Shapes."

Then open the Edit Shape dialog, pick your palette from the dropdown, and either assign the palette wholesale or click a member and click the icon you want it to use.

Your charts are only as useful as the traffic that sees them. Run a free SEO audit to find out where your analytics content is losing visibility.

When should you use icons instead of colour or size?

Use icons when the shape itself carries meaning that a colour cannot. A tick and a cross are understood instantly and in every language. A small flag says "country" without a legend. An arrow says direction.

Use icons when you need to encode a second dimension on top of colour. Colour by region and shape by product type and you have packed two categorical fields into one scatter plot without a second chart.

Use icons in text tables and KPI strips, where a small status marker in a column is faster to read than a word. This is the most underrated use of custom shapes in Tableau, and it is where a simple set of three traffic-light icons earns its keep.

Avoid icons when the field has many members, when the marks will render small, or when the icons are decorative rather than informative. A dashboard where every number has a little clip-art badge next to it is harder to read, not easier.

Avoid icons as a substitute for a chart type. If the comparison is about quantity, a position or a length encodes it better than a row of pictures ever will.

What are the limits of custom icons in Tableau?

They live on your machine, not in the cloud

This is the trap that catches almost everyone. The Shapes folder is a folder on your computer. A colleague opening your workbook does not have that folder.

Tableau handles this by saving custom shapes with the workbook, which is what makes a workbook with custom icons shareable at all. But the safe way to hand the workbook over is as a packaged workbook — a .twbx, which Tableau describes as "a single zip file that contains a workbook along with any supporting local file data and background images." Send the loose .twb and you are relying on the recipient having the same folder.

Web authoring is not the same as Tableau Desktop

Adding a palette means writing files to a repository folder. Browser-based authoring has no such folder, so custom palettes are a Desktop-side setup step. Build the view with its custom shapes in Desktop, then publish it.

Colouring only works on transparent shapes

If your PNG has a solid white background, Tableau's colour encoding has nothing to tint and the icon will stubbornly stay the colour you drew it. Export with transparency if you want Color and Shape to work together.

Size behaves differently from a circle

The Size slider scales your image. A detailed icon that looks crisp at 32 pixels can turn into a smudge at the small end of the slider. Test your palette at the size the marks will actually render, not at the size you drew it.

Tableau does not know your icons are related

A palette is just a folder of files, in whatever order the file system reports them. Tableau will not understand that your green tick belongs to "Pass" and your red cross to "Fail" — Assign Palette maps them arbitrarily, and you fix the mapping by hand afterwards. Naming files so they sort in the order you want helps, but it is a convention you are imposing, not a feature.

Icons are polish. Visibility is the foundation. Start with a free SEO audit and fix what is keeping your pages out of search results.

Icons vs the alternatives: which should you reach for?

Icons vs colour. Colour wins when you have few members and want the encoding to be visible at a glance across a crowded view. Icons win when the categories have natural visual symbols, or when colour is already spoken for by another field.

Icons vs labels. Labels are unambiguous and need no legend, which makes them the better choice for unfamiliar categories. Icons are faster to scan once learned and take far less horizontal space, which makes them better in dense tables.

Icons vs a dedicated chart. If you find yourself building an elaborate custom palette to imply a comparison, a bar chart or a dot plot is probably the honest version of that view. Shape is for identity, not for measurement.

Custom shapes vs background images. A custom shape is attached to a mark and repeats per data point. A background image sits behind the whole view. If you want a floor plan, a pitch or a map underneath your marks, that is a background image, not a shape palette.

Final Thoughts

Adding icons to Tableau is two separate skills wearing one name. The first is the built-in one: drop a dimension on Shape and let Tableau assign its ten shapes. That takes five seconds and solves most cases.

The second is the folder-based one: a named folder inside My Tableau Repository\Shapes, filled with transparent PNGs at roughly 32 by 32 pixels, loaded with Reload Shapes and applied from the Edit Shape dialog. That takes ten minutes once, and then every workbook you build can use your own visual language.

The failure mode to design around is sharing. Custom shapes are saved into the workbook, but a packaged .twbx is the version you actually send to people, and it is worth testing on a second machine before a dashboard goes out to a client.

And keep the restraint. Ten members is the ceiling the tool gives you, and in practice three to five distinct icons is where shape encoding is at its clearest. If you are reaching for a sixth, the question is usually whether shape is the right channel at all. If you are publishing these dashboards publicly, our guide to what Tableau Public is covers what travels with a workbook when you put it online.

Great dashboards deserve an audience. Claim your free SEO audit and find the gaps between your content and the people searching for it.