A dashboard extension is a web app inside of a dashboard on Tableau Server and Tableau Cloud. If you add an extension to a dashboard in web authoring, or publish a dashboard that contains a dashboard extension to Tableau Server or Tableau Cloud, you can debug the extension using the debugging tools that are built into the browser that you are using.
In this section
Open the workbook containing the extension in Tableau Server or Tableau Cloud.
Note: If the extension fails to load and you are using
localhost to serve your extension, you might encounter the mixed content security setting. To get past this issue, see Load and view localhost content on sites that use secure connections.
Open the debugging tools.
The process varies by browser. If you are using Chrome, enter CTRL + SHIFT + i (Windows) or COMMAND + OPTION + i (MacOS).
Locate the source code for your extension.
For example, if you were using Chrome for debugging, you can open the Source pane. Under folders shown on the navigation pane, you will find one for the extension. For example, you might see something like
Under this, you will find the name of the server (for example
If you need to debug your extension, setting a breakpoint in your source code is a good way to get started. When the breakpoint is hit, the code execution is paused in the debugger. You can then use the debugger controls to step through your code. You can use the debugging tools to see the values of local variables, and the call stack. You can also hover over in-scope variables in source window and see the current values.
Locate the line in your source code and set the breakpoint.
For example, you want to set this early in your code after the
initializeAsync() function call.
Refresh or reload the browser window.
You might see the permission dialog box prompt as the extension gets loaded.
Step through your code or set other breakpoints.
You can examine variables to see what information the extension has access to. For example, if you step or stop on the source line where you have access to the dashboard object, you can examine the values of the available resources in the dashboard.
// To get filter info, first get the dashboard. const dashboard = tableau.extensions.dashboardContent.dashboard;
Explore the dashboard extension namespace using the Console window.
For example, entering the following in the Console window (while you are paused in your extension code) will print out the names of all the worksheets in the dashboard.
In the Chrome browser, select Event Listener Breakpoint > Script > Script First Statement.
After you select the event breakpoint and refresh or reload the browser window, code execution will stop when every script is loaded.
Reload or refresh the browser.
You might need to click Continue many times, as code execution stops for all the scripts in the dashboard. If you are just looking to debug general initialization problems and haven’t tested your extension in Tableau Desktop, you might want to start there first.
In Tableau Desktop, there is a debugging option you can set to pause the extension when it is loading. For more information, see Debugging loading and initialization issues.
If your extension fails to load at all on Tableau Server or Tableau Cloud, check the console window of the debugger to see if there is an error message of some kind. The console messages can give you clues about where to begin investigating when something goes wrong. If the error is caused by mixed content (trying to load an HTTP web page inside of a secure HTTPS server), see Load and view localhost content on sites that use secure connections.
Mixed Content Warning
If you want to test and debug your extension (running on
http://localhost) with Tableau Cloud, or with a Tableau Server site that is using HTTPS, you might find that your extension fails to load. You won’t see any error message in the dashboard if this happens. There will just be an empty
iframe where the extension should appear. The reason for this is that the default settings of many browsers blocks the extension from loading because the extension is not using a secure connection (HTTPS).
To temporarily get around these safety settings for the session, you can click the shield icon (or lock icon) in the browser’s address bar. The alert dialog box will allow you to either load the scripts, or allow you to view the full content of the page. As soon as you load the unsafe scripts or allow the blocked content, the extension will load and will continue to be available for the duration of your session. Be sure to close the browser completely when you are finished testing. The following example shows what you might see in Chrome.
During the session, anytime you refresh or reload the web page, you will see the extensions dialog box requesting permission to run. And in the debugger console, you might see a warning message about mixed content.
Mixed Content: The page at 'https:/some_URLs#4' was loaded over HTTPS, but requested an insecure resource 'http://localhost:8765/Samples/Filtering/filtering.html'. This content should also be served over HTTPS.