Setup & site building · Guide
How to Embed Tableau Dashboard in WordPress (Step by Step)

Short answer
Open your published dashboard in Tableau, click Share and copy the embed code, then paste it into a Custom HTML block in WordPress. Set the width to 100 percent, give it enough height, and check the page while logged out, since private dashboards ask viewers to sign in.
Key takeaways
- Tableau Public, Cloud and Server all provide embed code.
- Paste the code into a Custom HTML block in the block editor.
- Only users with unfiltered HTML, usually admins, can save scripts.
- An iframe is a simple, reliable alternative to script embeds.
- Private dashboards show a sign-in prompt to visitors.
- Use device layouts in Tableau for readable mobile dashboards.
How do you embed a Tableau dashboard in WordPress?
Copy the embed code from the Share option in Tableau, paste it into a Custom HTML block in the WordPress editor, adjust the width and height, and preview the page.
Tableau dashboards are built to be shared on the web. Tableau Public, Tableau Cloud and Tableau Server all give you embed code that works in most web pages, including WordPress.
The main differences are who can see the dashboard and what code you get. A public dashboard shows to anyone. A dashboard on Tableau Cloud or Server asks viewers to sign in unless your organization has set up another method.
Tableau's own guide to embedding views into webpages covers the options in depth. This guide focuses on the WordPress side.
Which Tableau option are you using?
Check where the dashboard is published: Tableau Public for open data anyone can view, or Tableau Cloud and Tableau Server for private data that needs signed-in viewers.
| Platform | Who can view | What WordPress visitors see |
|---|---|---|
| Tableau Public | Anyone | The dashboard, no sign-in |
| Tableau Cloud | Licensed users | A sign-in prompt unless set up otherwise |
| Tableau Server | Users on that server | A sign-in prompt, depending on setup |
Never publish sensitive data to Tableau Public to make embedding easier. Everything there is visible to the world and can often be downloaded.
If your dashboard is private and your WordPress site is public, decide who should see it before you embed. A members-only page may be the better home.
Step 1: How do you copy the embed code from Tableau?
Open the published dashboard, click Share, and copy the embed code; on Tableau Public, use the share icon below the visualization and copy the embed code there.
On Tableau Public, open your visualization and look for the share option near the toolbar. It offers a link and an embed code.
On Tableau Cloud or Server, open the view and click Share. The dialog has a Copy Embed Code option.
Newer embed code uses Tableau's Embedding API, which loads a script and a tableau-viz element. Older code used an object tag and a different script. Both usually work, but copy fresh code rather than reusing old snippets.
Step 2: How do you add a Custom HTML block?
In the WordPress block editor, click the plus icon, search for Custom HTML, add the block where the dashboard should appear, and paste the embed code into it.
The Custom HTML block outputs your code without changing it, which embed code needs.
Use the block's Preview tab to check the code renders. Some embeds only appear on the published page or in the full preview, because the editor limits scripts.
If you use a page builder, add its HTML or code widget instead. Elementor, for example, has an HTML widget that works the same way.
If you use the classic editor, switch to the Text tab before pasting. Pasting into the visual tab can turn the code into plain text that shows on the page instead of running.
Save the page as a draft first and check the preview before publishing, so a broken embed never goes live.
Step 3: What does the embed code look like?
Modern embed code loads Tableau's embedding script and places a tableau-viz element that points to your view's URL, with optional attributes for the toolbar and tabs.
A simplified example looks like this. Copy your real code from Tableau's share dialog rather than typing this by hand:
<script type="module" src="https://YOUR-TABLEAU-HOST/javascripts/api/tableau.embedding.3.latest.min.js"></script>
<tableau-viz id="tableauViz"
src="https://YOUR-TABLEAU-HOST/views/WorkbookName/DashboardName"
toolbar="bottom" hide-tabs>
</tableau-viz>
Tableau's guide to writing embed code for views lists the attributes and parameters you can add, such as hiding tabs or the toolbar.
Can you use an iframe instead?
Yes; you can embed the view URL in an iframe, which some site owners prefer because it isolates Tableau's scripts from the rest of the page.
A basic iframe looks like this:
<iframe src="https://public.tableau.com/views/WorkbookName/DashboardName?:showVizHome=no&:embed=true"
width="100%" height="850" style="border:0" loading="lazy"
title="Sales dashboard"></iframe>
The title attribute helps screen reader users understand what the frame contains. The loading attribute lets the browser delay the frame until it is near the viewport. MDN's iframe reference explains each attribute.
The iframe approach gives you less control through Tableau's API, but it is simple and very reliable.
Why does WordPress strip the embed code?
WordPress removes scripts and some tags for users without the unfiltered HTML capability, which usually means only administrators can save raw embed code.
Editors and authors on a normal site cannot save script tags. On a multisite network, only super admins have that capability.
The WordPress Roles and Capabilities documentation explains which roles have unfiltered HTML.
If your code disappears after saving:
- Ask an administrator to add the block.
- Use the iframe version, which may survive filtering depending on your setup.
- Use a trusted embed or code snippet plugin that stores the code safely.
Do not give every user unfiltered HTML just to embed one dashboard. It lets them add any script to the site.
How do you make the dashboard fit on mobile?
Set the width to 100 percent, give enough height for the dashboard, and build device-specific layouts in Tableau so phones get a version designed for small screens.
Tableau dashboards are often designed at a fixed desktop size. On a phone, a fixed-size dashboard either shrinks until it is unreadable or forces sideways scrolling.
In Tableau Desktop, use the device layouts feature to create phone and tablet layouts. When the dashboard is embedded, Tableau can pick the right layout for the screen width.
In WordPress, use a full-width page template or a wide block alignment so the dashboard has room on desktop.
Do you need to sign in to see a Tableau Cloud dashboard?
Usually yes; viewers need permission on the Tableau site, and they see a sign-in prompt in the embedded frame unless your organization uses connected apps or another embedding authentication setup.
That works well for internal portals where staff already have Tableau accounts. It does not work for public visitors who have no login.
Options for sharing with a wider audience include publishing a version without sensitive data to Tableau Public, or working with your Tableau administrator on an authentication method designed for embedding.
The Embedding API basic embedding guide covers the developer side of these options.
Does an embedded dashboard slow down your page?
It can; Tableau loads its own scripts and data, so place the dashboard where it is needed and avoid putting several heavy dashboards on one page.
Tips to keep the page usable:
- Put a short summary and the key numbers above the dashboard in plain text.
- Use lazy loading on iframes so they load when visitors scroll to them.
- Split several dashboards across separate pages.
- Exclude the page from any optimization that delays or combines scripts if the dashboard fails to load.
Our guide on speeding up YouTube embeds uses the same lazy loading ideas for other heavy embeds.
Why is the embedded dashboard blank or blocked?
A blank frame usually means the view URL is wrong, the viewer lacks permission, a security header blocks framing, or a cache or script optimizer broke the embed code.
Check these points:
- Open the view URL directly in a private window to confirm it loads.
- Make sure the dashboard is published and shared with the right audience.
- Check your site's security headers. A strict content security policy may block Tableau's scripts or frames. Our guide to adding security headers to WordPress explains these policies.
- Turn off JavaScript delay and combine features for the page, then test.
- Look in the browser console for errors.
Browser privacy settings that block third-party cookies can also affect sign-in for Tableau Cloud and Server embeds.
Are there privacy points to consider?
Yes; Tableau embeds load content from Tableau's servers, which may set cookies, so mention them in your privacy policy and cookie notice where required.
This is general information, not legal advice. Our guide to GDPR compliance for WordPress covers how third-party embeds fit into privacy obligations.
If you already embed other tools, such as forms, the same approach applies. Our guide on embedding a Google Form in WordPress follows a similar process.
Frequently asked questions
Can I embed a Tableau dashboard in WordPress for free?
Yes, if the dashboard is on Tableau Public, which is free and lets anyone view published work. Embedding the code in WordPress costs nothing. Private dashboards on Tableau Cloud or Server need paid licenses for viewers, and visitors usually have to sign in.
Why does my Tableau embed code disappear after saving?
WordPress strips script tags for users who lack the unfiltered HTML capability. On most sites only administrators have it, and on multisite only super admins. Ask an administrator to add the code, use an iframe version, or use a trusted code embed plugin.
Can visitors without a Tableau account see my dashboard?
They can see dashboards published to Tableau Public. For Tableau Cloud or Server dashboards, visitors normally need an account with permission, or your organization must set up an embedding authentication method. Without one, they see a sign-in prompt inside the frame.
How do I make an embedded Tableau dashboard responsive?
Set the embed width to 100 percent and create device-specific layouts for phones and tablets in Tableau Desktop. A fixed-size desktop dashboard shrinks badly on small screens. Also place it in a wide or full-width area of the WordPress page.
Will a Tableau embed affect SEO?
Search engines generally cannot read the data inside an embedded dashboard. Add a written summary, key figures and a descriptive heading on the page so search engines and readers understand what the dashboard shows. This also helps visitors on slow connections.
Sources
- Embed Views into Webpages Tableau Help
- Writing Embed Code for Views Tableau Help
- Basic Embedding Tableau Embedding API
- Roles and Capabilities WordPress.org Documentation
- The Inline Frame element MDN Web Docs
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


