How to Embed Tableau Dashboard in Confluence

Putting a slick Tableau dashboard directly into a Confluence page bridges the gap between your data insights and team collaboration. It removes the extra step of clicking away to another tool, keeping your team focused and informed right where they work. This guide walks you through exactly how to embed your Tableau dashboards into Confluence, making your data a central part of your team's knowledge base.

Graphed

Still Building Reports Manually?

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

Watch the Demo

Why Embed a Tableau Dashboard in Confluence?

Before jumping into the "how," let's quickly cover the "why." Sending links to dashboards via email or Slack is fine, but it creates disconnected conversations. When you embed a dashboard directly into a Confluence page, you create a single source of truth that lives alongside project plans, meeting notes, and team documentation.

• Centralized Information: Your team's KPIs, project stats, or campaign results are right next to the written context, analysis, and action items. No more hunting for the right link or wondering which version of the data to trust.
• Improved Data Accessibility: It lowers the barrier for team members to engage with data. If the numbers are right there on the page they already use, they're far more likely to look at them, understand them, and use them to make decisions.
• Enhanced Collaboration: Discussions happen right on the Confluence page, with the relevant data visualization in plain sight. Team members can comment, ask questions, and assign tasks with full context.
• Live, Dynamic Data: Unlike a static screenshot, an embedded Tableau dashboard is interactive and updates automatically as your underlying data refreshes. Everyone is always looking at the most current information.

Graphed

Still Building Reports Manually?

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

Watch the Demo

Step 1: Get the Share Link or Embed Code from Tableau

Regardless of the method you choose for embedding, you first need to get the right sharing information from Tableau. This process works for both Tableau Cloud (formerly Tableau Online) and Tableau Server.

1. Open Your Dashboard: Navigate to the specific Tableau dashboard or view you want to share.
2. Find the 'Share' Button: Look for the "Share" icon, typically located in the top toolbar. Click on it.
3. Copy the Link or Embed Code: A dialog box will appear with a couple of options.

For now, just copy your preferred option to your clipboard. We'll use it in the next steps.

A quick note on permissions: Remember, embedding a dashboard in Confluence does not bypass Tableau's security. Viewers will still need to have the appropriate permissions on Tableau Server or Tableau Cloud to see the data. If they don't, they'll see a login prompt or an error message inside the embedded frame.

Method 1: The Official 'Tableau for Confluence' App

The cleanest and most reliable way to embed dashboards is by using the official app from the Atlassian Marketplace. It provides a dedicated macro designed specifically for this purpose.

If your organization uses Confluence Cloud or Data Center, this is the recommended approach. You might need to ask your Confluence administrator to install and configure it first.

Graphed

Still Building Reports Manually?

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

Watch the Demo

For Admins: Installing and Configuring the App

1. Navigate to "Settings" > "Find new apps" in Confluence.
2. Search for "Tableau for Confluence" and install the official app.
3. After installation, go to the app's configuration page. You'll need to connect it to your Tableau Online or Tableau Server instance by providing the server URL and setting up authentication. Follow the app's instructions to complete the connection.

For Users: How to Embed the Dashboard

Once the app is configured, embedding a dashboard is straightforward.

1. Edit a Confluence Page: Open the page where you want to add the dashboard and enter edit mode.
2. Insert the Tableau Macro: In the Confluence editor, type /tableau and press Enter. This will bring up the Tableau macro dialog.
3. Paste the URL: Take the URL you copied from the "Copy Link" option in Tableau and paste it into the URL field in the macro.
4. Adjust Options (Optional): The macro offers options to customize the display. You can often control the visibility of toolbars, tabs, and set the dashboard's height and width. For the best look, try setting the width to "100%" to make it responsive.
5. Insert and Publish: Click "Insert" to add the macro to your page, then publish the page to see your live, interactive Tableau dashboard in action.

Method 2: Using the Confluence HTML Macro

If you can't install the official app, the HTML macro is a solid workaround. Important: For security reasons, the ability to insert raw HTML is often disabled by default in Confluence. Your administrator must first enable the "HTML Macro" for this option to be available.

1. Get the Embed Code: Go back to Tableau and make sure you copy the full "Embed Code" (the one that starts with <iframe...>).
2. Edit your Confluence Page: Open your page in edit mode.
3. Insert the HTML Macro: Type /html and press Enter to add the macro to the page.
4. Paste the Code: Paste your entire Tableau iframe embed code into the body of the HTML macro.
5. Publish Your Page: Save the page. The content within the iframe should now render your Tableau dashboard.

You can manually edit the width and height attributes within the HTML code inside the macro to adjust the size of your dashboard on the page.

Method 3: Using a Generic iFrame Macro

Many Confluence instances have a general-purpose iFrame utility or macro installed, which can be used to embed any external content, including Tableau dashboards. This provides a good middle ground if the Tableau app isn't an option and the HTML macro is disabled.

1. Copy the Dashboard URL: For this method, you'll want the clean URL from Tableau's "Copy Link" option, not the full embed code.
2. Edit your Confluence Page: Enter edit mode for your desired page.
3. Find and Insert an iframe Macro: Type /iframe (or similar, the exact name might vary) and select the iframe macro from the list.
4. Enter the URL: In the macro's settings, paste the Tableau URL into the designated URL field.
5. Set the Dimensions: The macro should have fields for width and height. Enter values like "100%" for width and "800px" for height to start, then adjust as needed.
6. Save and Publish: Insert the macro and publish the page to see the results.

Graphed

Still Building Reports Manually?

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

Watch the Demo

Tips for Optimal Embedding

Embedding the dashboard is just the start. Here are a few tips to ensure a good experience for your team:

• Optimize for Performance: A massive, complex Tableau dashboard can make your Confluence page load slowly. Before embedding, try to optimize your workbook in Tableau. Use data extracts, limit the number of filters shown by default, and keep the initial view clean and focused.
• Think About Mobile View: Confluence is responsive, but your Tableau dashboard might not be. Design your dashboards with a 'fixed size' in Tableau if you want precise control, or experiment with 'automatic sizing' to see how it adapts to different screen sizes within the Confluence frame.
• Add Context on the Page: Don't just drop a dashboard on the page and call it a day. Add headings, text, and bullet points around the embed to explain what the data shows, what the key takeaways are, and what action items the team should consider. It turns a chart into a story.
• Double-Check Permissions: Before sharing the Confluence page widely, have a coworker who has Tableau access check if they can see the dashboard. Then, ask someone who doesn't have access to check. This helps you confirm what each user will experience and avoid a flood of "I can't see the chart" messages.

Final Thoughts

Embedding your Tableau dashboards in Confluence is a powerful way to make your data more visible, accessible, and actionable. Whether you use the official app or a macro workaround, bringing dynamic insights directly into your team's central workspace helps foster a more data-informed culture where decisions are made with full context.

Ultimately, the goal is to make it easy for your whole team to interact with data. When we built Graphed , we took this a step further by removing complexity at the creation stage, not just the sharing stage. Our platform connects to your marketing and sales data sources and lets you build entire dashboards and get immediate answers just by asking questions in plain English - no wrestling with BI tools required.