How to Embed Tableau

You’ve built an insightful Tableau dashboard, but its real power is unlocked when you bring it to where your audience already is - your company website, a SharePoint portal, or a specific blog post. Embedding your visualizations removes friction, placing dynamic, interactive data analysis directly in front of the people who need it most. This guide will walk you through the entire process, covering how to get the embed code, customize its appearance, and troubleshoot common issues along the way.

Graphed

Still Building Reports Manually?

Watch how growth teams are getting answers in seconds — not days.

Watch the Demo

Why Embed Tableau Dashboards in the First Place?

Before jumping into the “how,” it helps to understand the “why.” Embedding isn’t just about showing off a fancy chart, it’s a strategic way to make your data more accessible and impactful.

• Bring Data to Your Audience: People are far more likely to engage with data if it’s presented within the platforms they already use every day. Instead of sending a link and hoping they click, you surface the insights directly within their workflow.
• Enable Interactive Storytelling: A static image of a chart can only convey so much. An embedded Tableau dashboard allows users to click, filter, and hover to explore the data for themselves, leading to a much deeper understanding of the story you're telling.
• Keep a Single Source of Truth: When you embed a dashboard, it remains connected to its source in Tableau. If you update the data or visuals in Tableau Cloud or Server, the embedded view updates automatically everywhere it appears. This eliminates the confusion of 'version 2 final' spreadsheets circulating via email.
• Improve Decision-Making: By placing real-time operational or GTM dashboards directly in an internal portal or a strategy doc, you empower your team to make faster, more informed decisions based on the latest information, not stale reports.

Before You Start: What You Need

To successfully embed a Tableau view, you’ll need a few things squared away first. Getting these prerequisites handled will save you a lot of headaches later.

1. A Published Dashboard

You cannot embed a chart directly from Tableau Desktop. Your dashboard or "viz" (visualization) must be published in a Tableau environment that's accessible via the web. You have two primary options:

• Tableau Cloud (formerly Tableau Online) or Tableau Server: These are private, secure, and professional-grade solutions. You have full control over who can see your embedded dashboards. This is the standard for most business use cases.
• Tableau Public: A free service that's fantastic for sharing data publicly. The crucial thing to remember is that any data you publish here is, as the name implies, public. Never use Tableau Public for sensitive or proprietary company information.

2. The Right Permissions

Just because you can see a dashboard doesn’t mean the rest of the world can. To embed a dashboard from Tableau Cloud or Server, the people viewing the web page will need to have at least "Viewer" permissions in Tableau to see the viz. If your website is public, this either means you need to enable guest access on your server or use a different authentication method.

Graphed

Still Building Reports Manually?

Watch how growth teams are getting answers in seconds — not days.

Watch the Demo

3. Access to Your Website's HTML

Embedding a Tableau dashboard involves pasting a small snippet of HTML code into your web page. You’ll need the ability to edit the HTML of the website, blog, or portal where you want the dashboard to appear. Most modern content management systems (CMS) like WordPress, SharePoint, or Webflow have an option to add a “Custom HTML” block.

The Step-by-Step Guide to Embedding a Tableau Dashboard

With the prerequisites out of the way, you’re ready for the main event. The process is surprisingly straightforward.

Step 1: Get the Embed Code from Tableau

First, you need to grab the shareable code for your specific dashboard.

1. Log into your Tableau Cloud or Tableau Server account and navigate to the dashboard you want to embed.
2. Look for the Share button in the top toolbar. It’s typically represented by an icon with three connected dots. Click it.
3. A pop-up window will appear with several sharing options. Click on <, /, >, Copy Embed Code.

Tableau will automatically generate an HTML snippet and copy it to your clipboard. It will look something like this:

`<div class='tableauPlaceholder' id='viz1678886400000' style='position: relative'> <noscript><a href='#'><img alt='Dashboard 1 ' src='https://public.tableau.com/static/images/My/MyDashboardName/1_rss.png' style='border: none' /></a></noscript> <object class='tableauViz' style='display:none,'> <param name='host_url' value='https%3A%2F%2Fpublic.tableau.com%2F' /> <param name='embed_code_version' value='3' /> <param name='site_root' value='' /> <param name='name' value='MyDashboardName/Dashboard1' /> <param name='tabs' value='no' /><param name='toolbar' value='yes' /> <param name='static_image' value='https://public.tableau.com/static/images/My/MyDashboardName/1.png' /> <param name='animate_transition' value='yes' /> <param name='display_static_image' value='yes' /> <param name='display_spinner' value='yes' /> <param name='display_overlay' value='yes' /> <param name='display_count' value='yes' /> <param name='language' value='en-US' /> </object>

</div> <script type='text/javascript'> var divElement = document.getElementById('viz1678886400000'), vizElement = divElement.getElementsByTagName('object')[0], vizElement.style.width='100%',vizElement.style.height=(divElement.offsetWidth*0.75)+'px', var scriptElement = document.createElement('script'), scriptElement.src = 'https://public.tableau.com/javascripts/api/viz_v1.js', vizElement.parentNode.insertBefore(scriptElement, vizElement), </script>`

Graphed

Still Building Reports Manually?

Watch how growth teams are getting answers in seconds — not days.

Watch the Demo

Step 2: Paste the Code into Your Web Page

Now, head over to your website's content management system or HTML editor.

• For WordPress: In the block editor (Gutenberg), add a new block and search for "Custom HTML." Paste the embed code you copied into this block.
• For SharePoint: On a modern SharePoint page, add a new web part and choose "Embed." You'll be prompted to paste the code snippet there.
• For a regular HTML file: Simply paste the code into the <body> of your HTML where you want the dashboard to appear.

Once you save or publish your page, the Tableau dashboard should load in that spot.

Customizing Your Embedded View with Parameters

The default embed code works fine, but its true power comes from customization. You can control the appearance and functionality of your embedded dashboard by adding parameters to the URL within the code.

Look for the line in your code with the 'name' parameter, which contains your dashboard URL. You can append parameters to this URL to change its behavior. Simply add a ? after the dashboard name, followed by your parameter, using & to separate multiple parameters.

Common Parameters to Use:

• Control the UI Elements: Don't want users to see the full Tableau toolbar or workbook tabs? You can hide them. Example: param name='name' value='MyDashboard/Dashboard1?:embed=y&amp,:toolbar=no&amp,:tabs=no'
• Pre-Filter the View: This is incredibly useful. You can create one master dashboard but show a filtered version on different pages. For example, if you have a sales dashboard, you could create separate pages for each regional manager showing only their team's data. If you have a filter named "Sales Region" in your dashboard, you can embed a view showing only the "West" data. Example: param name='name' value='MyDashboard/SalesAnalysis?Sales%20Region=West'

Common Challenges and Troubleshooting Tips

Sometimes, things don't work perfectly on the first try. Here are some of the most common issues and how to fix them.

Problem: My embedded dashboard shows a login prompt or a blank space.

This is almost always a permissions issue. The person viewing the webpage does not have permission to view the viz on Tableau Cloud/Server. Check the sharing settings on the workbook in Tableau and ensure your intended audience has at least Viewer access. For public-facing sites, you may need your Tableau admin to enable "guest" access.

Graphed

Still Building Reports Manually?

Watch how growth teams are getting answers in seconds — not days.

Watch the Demo

Problem: The dashboard is cut off or doesn't fit correctly.

This is a sizing issue. The default embed code tries to be responsive, but it's not always perfect. You can manually adjust the width and height of the viz by modifying the JavaScript portion of the embed code. Look for this line: vizElement.style.width='100%',vizElement.style.height=(divElement.offsetWidth*0.75)+'px',. You can change 100% to a fixed pixel value like '800px' or adjust the height calculation as needed.

Problem: The dashboard filters and interactivity feel slow.

Performance is tied directly to the complexity of the dashboard itself. An embedded view has to run all the same calculations and queries as it does in Tableau. Before embedding, optimize your dashboard for performance. A few quick tips:

• Minimize the number of filters shown.
• Avoid high-cardinality "show all values" dropdown filters.
• Use data extracts instead of live connections when possible.

Final Thoughts

Embedding Tableau dashboards is a fantastic way to integrate live, interactive data into your websites and applications. By following the steps to generate the embed code and learning how to add a few simple parameters, you can customize the experience and put powerful insights directly into a useful context for your audience.

While embedding dashboards from traditional BI tools is effective, the process often requires navigating sharing settings, code snippets, and parameter adjustments. We built Graphed to make sharing your marketing and sales data much simpler. Instead of manually building and embedding charts, you can use plain English to create real-time dashboards from sources like Google Analytics, Shopify, and Salesforce in seconds. Our interactive dashboards are live, easy to share securely with your team, and let you get straight to the insights without the setup hurdles. You can try Graphed for yourself and experience a faster way to get answers from your data.