---
schema_version: "1"
id: 723c914cd1e0afc0479672355e95b2de4819b7af84e21d6941db36fa13f0ba51
title: Troubleshooting for Tableau Next Embedding
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/sdk/guides/sdk-troubleshooting.md
canonical_url: https://developer.salesforce.com/docs/analytics/sdk/guide/sdk-troubleshooting.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: e9c06a51ebff6f8be6c9f04c0a0579e82d82ee3cbc69985823d9191ca9c05861
products:
  - Tableau Next Embedding SDK
  - analytics
---
# Troubleshooting for Tableau Next Embedding

There are various error scenarios that may occur during the implementation of embedding Tableau Next components into your web app using the SDK. Each error has an explanation and a resolution.

## Error Handling

| Error Code | Error Message | Resolution |
| ---------- | ------------- | ---------- |
| `INITIALIZATION_ERROR` | `Script load failed: <orgURL>` | Ensure the `orgUrl` value provided in the embedding code matches your Salesforce org URL. For more information, see [Add the Tableau Next Component to Your Web App](https://developer.salesforce.com/docs/analytics/sdk/guide/sdk-integration-initialize-embed.md). |
| `AUTH_ERROR` | `LOError: LOApplication: frontdoorURL must be a valid URL` | Ensure the value passed to `authCredential` is a valid Frontdoor URL. Your token broker generates this URL at runtime by POSTing the OAuth access token to `<instance_url>/services/oauth2/singleaccess` and reading `frontdoor_uri`. This is a short-lived value. For more information, see [Generate the Access Token and Frontdoor URL for Tableau Next Embedding](https://developer.salesforce.com/docs/analytics/sdk/guide/sdk-access-token.md). |
| `CONFIGURATION_ERROR` | `Missing required params: idOrApiName` | Ensure the `idOrApiName` value is provided in the embedding code. For more information, see [Add the Tableau Next Component to Your Web App](https://developer.salesforce.com/docs/analytics/sdk/guide/sdk-integration-initialize-embed.md). |
| `CONFIGURATION_ERROR` | `Missing required params: Page with label {pageName} not found` | Ensure the `pageName` value is correct in the embedding code. |
| `RESOURCE_NOT_FOUND` | `Dashboard with <idOrApiName> not found` | Ensure the `idOrApiName` value is correct in the embedding code. For more information, see [Add the Tableau Next Component to Your Web App](https://developer.salesforce.com/docs/analytics/sdk/guide/sdk-integration-initialize-embed.md). |
| `INTERNAL_ERROR` | `Failed to fetch metric: <idOrApiName>` | Ensure the `idOrApiName` value is correct in the embedding code. For more information, see [Add the Tableau Next Component to Your Web App](https://developer.salesforce.com/docs/analytics/sdk/guide/sdk-integration-initialize-embed.md). |
| `INVALID_SESSION` | `Invalid session` | Ensure you have a code implementation for reauthorizing user sessions. |
| `UNHANDLED_REJECTION` | `Unhandled Promise Rejection: Lightning Out container error: LWR3009: Unable to resolved bare specifier: analytics_business_user/metric/v/0_0_1` | Contact Salesforce support. |

## idOrApiName Parameter Error
The `idOrApiName` parameter is required. If this parameter is missing for the initialization of any components, then the SDK throws an error to the console.

```json
{
  "errorCode": "INTERNAL_ERROR",
  "message": "Missing required params: idOrApiName"
}
```

## Invalid UnifiedFilterJson Error
When the filter is built with invalid values, the `applyFilters` call fails with an INTERNAL_ERROR event. Failures occur when the data source name isn't found, the field name isn't found in the data source, the filter operator isn't a correct enumerated value, or the values in the filter values are invalid. Invalid filter values can occur when the value type doesn't match the field type or there are mixed value types in the values array.

### Example: Filter values are invalid
```json
{
  "errorCode": "INTERNAL_ERROR",
  "message": "Invalid values in filter JSON"
}