---
title: "Troubleshooting Tableau Dashboard Embeds in Jira"
canonical: "https://support.appfire.com/space/SUPPORT/3496018030/Troubleshooting%20Tableau%20Dashboard%20Embeds%20in%20Jira"
format: markdown
---
This article explains how to troubleshoot Tableau dashboard embeds when using Tableau Connector Pro for Jira and the embedded dashboard does not render correctly inside a Jira dashboard gadget, even though the same link opens successfully in a regular browser tab.

> ℹ️ Use this guide when the Tableau content is reachable in a browser, but fails or behaves unexpectedly when added through the Jira dashboard embed workflow.

# Problem

A Tableau dashboard may fail to display inside a Jira dashboard gadget despite the dashboard being valid and accessible outside Jira. This can happen when the shared Tableau URL is not in the expected format for embedding, or when the Tableau domain has not been allowed in Jira.

# What to check first

- Confirm the Tableau dashboard opens correctly in a standard browser window.
- Confirm you are using a **shared** Tableau dashboard link intended for embedding or sharing.
- Confirm the Tableau domain used by the shared link is allowed by your Jira configuration.

> 📝 This feature is intended to display a shared Tableau dashboard inside Jira. If a copied link works in one context but not in the gadget, the issue is often the exact link format rather than dashboard permissions alone.

# Solution

Follow these steps to resolve the issue.

1. Open the Tableau dashboard you want to embed.
2. Use Tableau’s **Share** option from the dashboard, and copy the generated share link instead of reusing a browser URL from another location.
3. Verify that the Tableau site domain used by that link is whitelisted or allowed in Jira, if your Jira setup requires external domains to be approved.
4. When pasting the URL into the Jira dashboard gadget, make sure the link is entered in its working shared format, including the trailing `?` if Tableau provides it that way.
5. Save the gadget and reload the Jira dashboard to confirm the embedded view renders correctly.

# Why this works

Tableau can produce different URL variants for the same dashboard. Some links are suitable for direct browser access but do not work reliably in embedded gadget scenarios. The shared link generated from Tableau’s **Share** action is the safest choice for Jira embedding because it matches the expected format more closely.

Additionally, some Jira environments require external content domains to be explicitly allowed. If the Tableau domain is not approved, the gadget may fail before the dashboard itself is even evaluated.

# Common mistakes

- Using a browser URL instead of the Tableau **Share** link.
- Removing characters from the end of the shared URL, especially the trailing `?` when present.
- Testing only in a browser tab and assuming the same URL will behave identically inside an embedded Jira gadget.
- Forgetting to allow the Tableau domain in Jira when external domains are controlled.

# Recommended troubleshooting flow

1. Test the dashboard URL in a normal browser window.
2. Generate a fresh share link directly from Tableau.
3. Compare the working browser link and the shared link for formatting differences.
4. Check whether the Tableau domain is approved in Jira.
5. Paste the shared link exactly as generated into the gadget, without trimming the end of the URL.

<details>
<summary>Advanced troubleshooting tip</summary>

If the dashboard still does not load, capture a browser HAR file while reloading the Jira dashboard page. Review failed network requests, blocked domains, redirects, and iframe-related loading errors. This can help identify whether the failure is caused by URL formatting, domain restrictions, or browser/network policy behavior.
</details>

# FAQ

<details>
<summary>The Tableau dashboard opens in a browser. Why does it still fail in Jira?</summary>

A browser tab and an embedded gadget do not always handle Tableau URLs the same way. A direct browser URL may open normally, while the gadget expects a shared embed-friendly URL format.
</details>

<details>
<summary>Should I use the URL from the address bar or the Share option in Tableau?</summary>

Use the URL generated from Tableau’s **Share** option. It is the preferred format for embedding inside Jira.
</details>

<details>
<summary>Does the trailing ? at the end of the Tableau URL matter?</summary>

Yes. If Tableau provides the shared link with a trailing `?`, keep it. Removing it can prevent the gadget from rendering the dashboard correctly.
</details>

<details>
<summary>Do I need to allow the Tableau domain in Jira?</summary>

In environments that restrict external content sources, yes. The Tableau domain used by the shared link must be allowed for the gadget to load the dashboard.
</details>

# Related article

[https://appfire.atlassian.net/wiki/spaces/ATCFJ/pages/65634539](https://appfire.atlassian.net/wiki/spaces/ATCFJ/pages/65634539)