What is Tableau URI?

Ever wanted to share a Tableau dashboard that automatically opens with specific filters already applied? You can stop telling colleagues to "open the link, then filter for the West region, and then select the Corporate segment." Instead, you can send them a single, intelligent link that does all the work for them. This is made possible by using a Tableau URI. This article will walk you through exactly what a Tableau URI is, how to build one step-by-step, and how you can use them to make sharing your data visualizations more efficient and user-friendly.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

Understanding the Basics: What Exactly is a Tableau URI?

In simple terms, a Tableau URI (Uniform Resource Identifier) is a special kind of web link that points to a specific Tableau view - which could be a worksheet, a dashboard, or a story. The real power of a Tableau URI is its ability to include an extra set of instructions at the end of the link. These instructions, known as parameters, tell Tableau how to display the view when someone clicks on it.

Think of it like sharing a link to a YouTube video. You could send a generic link to the whole video, or you could send a link that starts the video at a specific timestamp, like 2 minutes and 15 seconds in. A Tableau URI does the same thing for your data.

Instead of just sending a link to your main sales dashboard, you can create a URI that shows the dashboard already filtered for:

• A specific sales region.
• A particular product category.
• A date range from the last quarter.

This simple trick transforms a static link into a dynamic tool, allowing you to create custom views of your data on the fly without having to create dozens of different dashboard versions. It saves you time, reduces confusion for your audience, and gets them straight to the insights that matter most to them.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

The Anatomy of a Tableau URI

To build a URI, you first need to understand its components. A Tableau URI looks like a standard URL but with a few extra pieces tacked on at the end. Let's break it down.

Here’s a sample URI:

http://mytableauserver/views/SalesDashboard/GlobalSales?Region=East&amp,Segment=Consumer

This link is made up of three main parts:

1. The Base URL: http://mytableauserver/views/SalesDashboard/GlobalSales

This is the standard part of the link that points to your specific view. It starts with your Tableau Server address (or Tableau Cloud/Public) and navigates through the workbook (SalesDashboard) to the specific view you want to show (GlobalSales). You can get this base URL easily by clicking the "Share" button on any Tableau view.

2. The Query String Delimiter (?): Immediately following the base URL, you’ll find a question mark. This symbol is crucial - it signals to the browser that everything following it is a set of parameters, often called a "query string."

3. Parameters and Values: Region=East&amp,Segment=Consumer

This is where the magic happens. A parameter is a key-value pair that tells Tableau exactly how to filter or modify the view. In our example:

• The first parameter is Region=East. Here, Region is the field name you want to filter, and East is the value you want to filter for.
• The ampersand &amp, is used to separate multiple parameters.
• The second parameter is Segment=Consumer. Here, Segment is the field name, and Consumer is the filter value.

When a user clicks this complete link, Tableau reads these instructions and immediately applies the filters, showing them the GlobalSales dashboard filtered only for the "East" region and the "Consumer" segment.

How to Build a Tableau URI: A Step-by-Step Guide

Building your own Tableau URI is a straightforward process. Let's walk through it with a practical example. Imagine we have a sales dashboard and we want to create a link for our West Coast manager that shows them sales data for only the "Technology" product category.

Step 1: Get the Base URL

First, navigate to the dashboard you want to share on your Tableau Server or Tableau Cloud account. Click the Share button. A dialog box will appear with a link. Copy this link - this is your base URL.

It will look something like this: https://10az.online.tableau.com/t/mycompany/views/SuperstoreSales/Overview

Step 2: Identify the Fields You Want to Filter

Next, you need to know the exact names of the fields you want to use as filters. In our dashboard, we want to filter by the Region field and the Category field. It's important to use the exact field names as they appear in your data source in Tableau. Case sensitivity can also matter, so double-check the spelling and capitalization.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

Step 3: Add Your First Filtering Parameter

Take your base URL and add a question mark (?) at the end. Then, add your first key-value pair. We want to filter for the West region, so our parameter will be Region=West.

Your URI now looks like this: https://10az.online.tableau.com/t/mycompany/views/SuperstoreSales/Overview?Region=West

If you paste this URL into your browser, it will now open the dashboard pre-filtered to show only data from the West region.

Step 4: Add More Parameters

We're not done yet. We also want to filter for the "Technology" category. To add a second (or third, or fourth) parameter, you use an ampersand (&). So, we'll add &Category=Technology to the end of our URI.

The final, complete URI is: https://10az.online.tableau.com/t/mycompany/views/SuperstoreSales/Overview?Region=West&amp,Category=Technology

Now, this single link will take your West Coast manager directly to a view of the sales dashboard showing only technology products sold in the West region.

Handling Spaces and Special Characters in Field Names

What if your field name has a space, like "Product Sub-Category"? Web links can't contain spaces. Instead, they must be "URL encoded." For URIs, a space is represented by %20.

So, a filter for Product Sub-Category = "Bookcases" would be written in the URI as: Product%20Sub-Category=Bookcases

This applies to both the field name and its value. For example, if you wanted to filter for a value like "New York", your parameter would be State=New%20York.

Pro-Tip: To avoid this hassle, it's a good practice to use field names without spaces or special characters in Tableau whenever possible (e.g., ProductSubCategory instead of Product Sub-Category).

Practical Use Cases for Tableau URIs

Now that you know how to build them, where can you use these powerful links? Here are a few common scenarios where Tableau URIs shine:

• Personalized Communication: Send targeted email updates to regional managers with links that open the company dashboard pre-filtered for their specific territory. No more wasted time applying filters.
• Internal Knowledge Hubs: On a company wiki or a tool like Confluence, you can create a single 'Sales Dashboard' page. On that page, provide multiple links, each tailored for different teams: "View Marketing Performance," "View Q4 Sales Targets," or "View Logistics Data," all pointing to the same dashboard but with different default filters applied.
• Integration with Other Apps: You can embed dynamic Tableau links into other applications. For instance, you could add a button on an account page in Salesforce that says "View Sales History." When clicked, it opens a Tableau dashboard already filtered for that specific account's ID.
• Improving Website User Experience: If you embed a Tableau dashboard on your company's website, you can use buttons or links on the page to change the viz's filters using URI parameters, making it more interactive for visitors.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

Advanced Tips and Tricks

Once you've mastered the basics, you can do even more with Tableau URIs.

Filtering by Multiple Values: What if you want to filter for more than one value in a single field? For example, showing data for both the "West" and "Central" regions. To do this, simply separate the values with a comma.

...?Region=West,Central

Filtering on a Date Range: You can filter date fields, too. Just be sure to use Tableau's default date format, which is YYYY-MM-DD. You can specify a start and end date for a range.

...?Order%20Date=2024-01-01,2024-03-31

Controlling the Tableau Interface upon Embedding: When you're embedding a Tableau dashboard into another webpage or application, you might want to hide the default toolbar or tabs to create a cleaner look. You can do this with special command parameters that start with a colon (:).

• :embed=y - This tells Tableau that the view is embedded, which can optimize its rendering.
• :toolbar=n - This hides the top toolbar (Undo, Redo, Share, etc.). Use n for the value.
• :tabs=n - This hides the tabs for any other sheets in the workbook.

You can combine these with your filter parameters. It typically works best to place these command parameters right after the question mark and before any filters.

Example of a clean embedded view filtered for the East region: .../Overview?:embed=y&amp,:toolbar=n&amp,:tabs=n&amp,Region=East

Mastering these URIs allows you to deliver highly specific and relevant data views to anyone, anywhere, with just a single click.

Final Thoughts

Tableau URIs are a simple yet extremely effective feature for anyone who shares data visualizations. By adding parameters directly to your URLs, you can create custom, pre-filtered views that save your audience time and help them focus on the exact insights you want to convey. It moves you from sharing a generic tool to delivering a specific answer.

Building dashboards in Tableau and then crafting specific URIs to share is a powerful workflow, but it can still be a multi-step process. At Graphed , we automate and simplify your entire analytics process. We allow you to connect all your data sources - like Salesforce, Google Analytics, Shopify, and more - and use simple, conversational language to build dashboards in seconds. Instead of figuring out field names and URL encoding, you can just ask, "Show me a chart of sales by product category for the West region," and get a real-time, shareable visualization instantly.