---
schema_version: "1"
id: 03a070a9d01bb0ae9b15030eb293209eca03989fdc601b714f98706d019e6122
title: Troubleshooting and Debugging
collection: tableau
version: next
locale: en-us
portal_url: https://docs.salesforce.com/tableau/next/en-us/api/embedding_api/docs/embedding_api_troubleshoot.md
canonical_url: https://help.tableau.com/v0.0/api/embedding_api/en-us/docs/embedding_api_troubleshoot.html
source_site: help.tableau.com
content_type: documentation
content_hash: 75cecfebfcf16a66872b30dea091056f02d89770fb4425b102831295e90da732
description: Documentation for the Tableau Embedding API
---
# Troubleshooting and Debugging
## Debugging your web application with the embedded view
The most convenient way to debug your web application is to use the debugging tools built into your web browser. Using the debugging tools, you can set breakpoints, examine data structures, and view console messages.
### Use the non-minified version of the Embedding API v3 library
To improve web page load times and the user experience, you typically want to use the minified version of the Embedding API v3 library (`tableau.embedding.3.latest.min.js`). However, while you are developing your application, we recommend that you use the non-minified version of the Embedding API v3 library. You can access non-minified versions of the library by removing `.min` from the filename, for example, `tableau.embedding.3.latest.js`. The non-minified version of the library is easier to read, and includes symbol information that can help when you need to debug your embedding code.
For example, to link to the library for debugging from Tableau Cloud, you might include the following `
```
To better understand and debug issues with your embedded view, set breakpoints and use `console.log` statements in your code, so you can see that the objects and values are returned and passed between methods. You can also use the debugging tools to drill down to examine properties and structures.
```
let viz = document.getElementById("tableauViz");
console.log(viz);
```
## Troubleshooting
The following section describes some common issue you might encounter and provides some suggestions about resolving them.
### Compatibility
**Problem:** The embedded viz appears in your web application and the viz is interactive (that is, you can select marks or set filters in the viz directly), but the two-way communication is not working (that is, calls to the Embedding API v3 don’t work; your web application can’t interact with the embedded viz).
**Try this**
- Use your debugging tools and check the console log. Look for an error: `bad version of server`.
- If you see a bad version of server error, this indicates that version of the Embedding API library you are using is incompatible with the version of Tableau Server that is hosting the viz. To find out which version you should be using, see this [compatibility matrix](/v0.0/api/embedding_api/en-us/docs/embedding_api_get.html#versions-of-the-tableau-embedding-api).
- As a general practice, if you are accessing the Embedding API v3 library on Tableau Server, Tableau Cloud, or Tableau Public, you should link to the most recent version of the library (`tableau.embedding.3.latest.js`, or `tableau.embedding.3.latest.min.js`).
* * *
### Blank iframe (Tableau viz does not appear)
**Problem:** In your web application there is a blank iframe where the embedded view should be. Open your debugging tools and look for any error messages.
#### Invalid URL error
```dotnetcli
Error: invalid-url: Failed to construct 'URL': Invalid URL
```
If you are getting this error, it means the the `src` for the embedded viz is not set correctly. The best way to get the URL that you use for the `src` is to click the Share button on the Tableau toolbar and then use the Copy Link button. If you were initializing the Embedding API using JavaScript (as opposed to the `` web component), you might have a statement like `viz.src = 'https://public.tableau.com/views/RegionalSampleWorkbook/Storms';` in your code. If you were embedding the view using the web component, it might look like the the following:
```
```
#### Import error
If the view fails to load, open the browser debugging tools and check the console for error messages.
* * *
```dotnetcli
Uncaught SyntaxError: Cannot use import statement outside a module
```
Or you might see the following error:
```dotnetcli
Uncaught SyntaxError: Unexpected token 'export'
```
You might see this error depending on how you are initializing and the embedding the viz. If are using JavaScript to initialize the viz, and you’ve created a separate file with your JavaScript code, where you import the library, check how you include that JavaScript file in your HTML page. You should set `type="module"`. For example, if you import the library in a file called `initialization.js`:
```
import {
TableauViz,
TableauEventType,
FilterUpdateType,
} from 'https://public.tableau.com/javascripts/api/tableau.embedding.3.latest.min.js';
```
In your HTML web page, you need to be sure to include the file using `type="module"`.
```HTML
```
If you are using one of the Tableau web components to embed the viz and you are importing the library using script tags in your HTML code, be sure to set the `type` as `module`.
```HTML
```
#### Cross-origin request (CORS) error
* * *
```dotnetcli
Access to script at 'file:///Users/' from origin 'null' has been blocked by CORS policy: Cross origin requests are only supported for protocol schemes: `http`, `data`, `chrome`, `chrome-extension`, `chrome-untrusted`, `https`.
```
If you link to a local version of the Embedding API library, or load your web application from the file system, you could see this error. For the Embedding API library, you can avoid this problem by using the hosted version on the CDN: `https://embedding.tableauusercontent.com/tableau.embedding.3.1.0.min.js`. For more information about linking to the Embedding API library, see [Access the Embedding API](/v0.0/api/embedding_api/en-us/docs/embedding_api_get.html).
* * *
### Request count exceeded error
This error occurs when the user account has reached the threshold of 600 views/hour. See [Tableau Cloud Site Capacity](https://help.tableau.com/current/online/en-us/to_site_capacity.htm). If you see this error, contact your Tableau account manager.
#### On This Page