EmbedConfig

The configuration object for embedding ThoughtSpot content. It includes the ThoughtSpot hostname or IP address, the type of authentication, and the authentication endpoint if a trusted authentication server is used.

Properties🔗

additionalFlags🔗

additionalFlags: {[key: string ] : string | number | boolean}

Optional

This is an object (key/val) of override flags which will be applied to the internal embedded object. This can be used to add any URL flag. Warning: This option is for advanced use only and is used internally to control embed behavior in non-regular ways. We do not publish the list of supported keys and values associated with each.

Index Signature Parameters

Version : SDK: 1.33.5 | ThoughtSpot: *

const embed = new LiveboardEmbed('#embed', {
  ... // other liveboard view config
  additionalFlags: {
       flag1: 'value1',
       flag2: 'value2'
    }
});

authEndpoint🔗

authEndpoint: string

Optional

[AuthServer] The trusted authentication endpoint to use to get the authentication token. A GET request is made to the authentication API endpoint, which returns the token as a plaintext response. For trusted authentication, the authEndpoint or getAuthToken attribute is required.

authTriggerContainer🔗

authTriggerContainer: string | HTMLElement

Optional

For inPopup SAMLRedirect or OIDCRedirect authentication, we need a button that the user can click to trigger the flow. This attribute sets a containing element for that button.

Version : SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw

init({
  authType: AuthType.SAMLRedirect,
  inPopup: true,
  authTriggerContainer: '#auth-trigger-container'
})

authTriggerText🔗

authTriggerText: string

Optional

Text to show in the button which triggers the popup auth flow. Default: Authorize.

Version : SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw

authType🔗

authType: AuthType

The authentication mechanism to use.

autoLogin🔗

autoLogin: boolean

Optional

Re-login a user with the previous login options when a user session expires.

default : false

blockNonEmbedFullAppAccess🔗

blockNonEmbedFullAppAccess: boolean

Optional

Prevent embedded application users from accessing ThoughtSpot application pages outside of the iframe.

Version : SDK: 1.22.0 | ThoughtSpot: 9.3.0.cl, 9.5.1.sw

default : true

callPrefetch🔗

callPrefetch: boolean

Optional

Calls the prefetch method internally when set to true

default : false

cleanupTimeout🔗

cleanupTimeout: number

Optional

The timeout for the cleanup to be completed before destroying the embed.

Version : SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl

default : 5000

currencyFormat🔗

currencyFormat: string

Optional

Format to be used for currency when currency format is set to infer from browser

Version : SDK: 1.28.4 | ThoughtSpot: 10.0.0.cl, 9.5.0.sw

customActions🔗

customActions: CustomAction[]

Optional

Custom Actions allows users to define interactive UI actions (like buttons or menu items) that appear in ThoughtSpot’s visualizations, answers, and Liveboards. These actions enable users to trigger custom workflows — such as navigating to an external app, calling an API, or opening a modal — based on the data context of what they clicked can be used to trigger custom logic when the action is clicked.

Version : SDK: 1.43.0 | ThoughtSpot: 10.14.0.cl

import { CustomActionsPosition, CustomActionTarget } from '@thoughtspot/visual-embed-sdk';
init({
  ... // other embed config options
  customActions: [
    {
      // Unique identifier for the custom action
      id: 'my-custom-action',

      // Display name shown to users in the UI
      name: 'My Custom Action',

      // Where the action appears in the UI
      // PRIMARY: Shows as a primary button (e.g., in the toolbar)
      // MENU: Shows in the "More" menu (three dots menu)
      // CONTEXTMENU: Shows in the right-click context menu
      position: CustomActionsPosition.PRIMARY,

      // What type of content this action applies to
      // ANSWER: Available on answer pages
      target: CustomActionTarget.ANSWER,

      // Optional: Restrict where this action appears based on data models
      // dataModelIds: {
      //     // Restrict to specific data models
      //     modelIds: ['model-id-1', 'model-id-2'],
      //     // Restrict to specific columns within models
      //     modelColumnNames: ['model-id::column-name']
      // },

      // Optional: Restrict where this action appears based on metadata
      // metadataIds: {
      //     // Restrict to specific answers
      //     answerIds: ['answer-id-1', 'answer-id-2'],
      // },
      //     // Restrict to specific groups (for group-based access control)
      //     groupIds: ['group-id-1', 'group-id-2'],
      //     // Restrict to specific organizations (for multi-org deployments)
      //     orgIds: ['org-id-1', 'org-id-2'],
    }
  ],
})

import { CustomActionsPosition, CustomActionTarget } from '@thoughtspot/visual-embed-sdk';
init({
  ... // other embed config options
  customActions: [
    {
      // Unique identifier for the custom action
      id: 'my-custom-action',

      // Display name shown to users in the UI
      name: 'My Custom Action',

      // Where the action appears in the UI
      // MENU: Shows in the "More" menu (three dots menu)
      // CONTEXTMENU: Shows in the right-click context menu
      position: CustomActionsPosition.MENU,

      // What type of content this action applies to
      // SPOTTER: Available in Spotter (AI-powered search)
      target: CustomActionTarget.SPOTTER,

      // Optional: Restrict where this action appears based on data models
      // dataModelIds: {
      //     // Restrict to specific data models
      //     modelIds: ['model-id-1', 'model-id-2'],
      // },
      //     // Restrict to specific groups (for group-based access control)
      //     groupIds: ['group-id-1'],
      //     // Restrict to specific organizations (for multi-org deployments)
      //     orgIds: ['org-id-1'],
    }
  ],
})

import { CustomActionsPosition, CustomActionTarget } from '@thoughtspot/visual-embed-sdk';
init({
  ... // other embed config options
  customActions: [
    {
      // Unique identifier for the custom action
      id: 'my-liveboard-custom-action',

      // Display name shown to users in the UI
      name: 'My Liveboard Custom Action',

      // Where the action appears in the UI
      // PRIMARY: Shows as a primary button (e.g., in the toolbar)
      // MENU: Shows in the "More" menu (three dots menu)
      position: CustomActionsPosition.PRIMARY,

      // What type of content this action applies to
      // LIVEBOARD: Available on liveboard pages
      target: CustomActionTarget.LIVEBOARD,

      // Optional: Restrict where this action appears based on metadata
      // metadataIds: {
      //     // Restrict to specific liveboards
      //     liveboardIds: ['liveboard-id-1', 'liveboard-id-2'],
      // },
      //     // Restrict to specific groups (for group-based access control)
      //     groupIds: ['group-id-1', 'group-id-2'],
      //     // Restrict to specific organizations (for multi-org deployments)
      //     orgIds: ['org-id-1', 'org-id-2'],
    },
    {
      // Unique identifier for the custom action
      id: 'my-viz-custom-action',

      // Display name shown to users in the UI
      name: 'My Viz Custom Action',

      // Where the action appears in the UI
      // PRIMARY: Shows as a primary button (e.g., in the toolbar)
      // MENU: Shows in the "More" menu (three dots menu)
      // CONTEXTMENU: Shows in the right-click context menu
      position: CustomActionsPosition.PRIMARY,

      // What type of content this action applies to
      // VIZ: Available on individual visualizations
      target: CustomActionTarget.VIZ,

      // Optional: Restrict where this action appears based on metadata
      // metadataIds: {
      //     // Restrict to specific answers
      //     answerIds: ['answer-id-1', 'answer-id-2'],
      //     // Restrict to specific liveboard. If liveboardId is
      //     // passed, custom actions will appear on all vizzes of liveboard
      //     liveboardIds: ['liveboard-id-1'],
      //     // Restrict to specific vizIds
      //     vizIds: ['viz-id-1']
      // },
      // dataModelIds: {
      //     // Restrict to specific data models
      //     modelIds: ['model-id-1', 'model-id-2'],
      //     // Restrict to specific columns within models
      //     modelColumnNames: ['model-id::column-name']
      // },
      //     // Restrict to specific groups (for group-based access control)
      //     groupIds: ['group-id-1', 'group-id-2'],
      //     // Restrict to specific organizations (for multi-org deployments)
      //     orgIds: ['org-id-1', 'org-id-2'],
    }
  ],
})

customVariablesForThirdPartyTools🔗

customVariablesForThirdPartyTools: Record< string, any >

Optional

This is an object (key/val) for customVariables being used by the third party tool’s script.

Version : SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl

const embed = new LiveboardEmbed('#embed', {
  ... // other liveboard view config
  customVariablesForThirdPartyTools: {
       key1: 'value1',
       key2: 'value2'
    }
});

customizations🔗

customizations: CustomisationsInterface

Optional

Custom style params for embed Config.

Version : SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw

dateFormatLocale🔗

dateFormatLocale: string

Optional

Overrides default/user preferred locale for date formatting

Version : SDK: 1.28.4 | ThoughtSpot: 10.0.0.cl, 9.5.0.sw

detectCookieAccessSlow🔗

detectCookieAccessSlow: boolean

Optional

[AuthServer|Basic] Detect if third-party cookies are enabled by doing an additional call. This is slower and should be avoided. Listen to the NO_COOKIE_ACCESS event to handle the situation.

This is slightly slower than letting the browser handle the cookie check, as it involves an extra network call.

Version : SDK: 1.10.4 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw

disableFullscreenPresentation🔗

disableFullscreenPresentation: boolean

Optional

Disable fullscreen presentation mode functionality. When enabled, prevents entering and exiting fullscreen mode for embedded visualizations during presentations.

Version : SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl

default : true (feature is disabled by default)

init({
  ... // other embed config options
  disableFullscreenPresentation: false, // enables the feature
})

disableLoginFailurePage🔗

disableLoginFailurePage: boolean

Optional

This flag is used to disable showing the login failure page in the embedded app.

Version : SDK: 1.32.3 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw

disableLoginRedirect🔗

disableLoginRedirect: boolean

Optional

Disable redirection to the login page when the embedded session expires This flag is typically used alongside the combination of authentication modes such as AuthType and auto-login behavior EmbedConfig.autoLogin

Version : SDK: 1.9.3 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw

default : false

disablePreauthCache🔗

disablePreauthCache: boolean

Optional

disableSDKTracking🔗

disableSDKTracking: boolean

Optional

Disables the Mixpanel tracking from the SDK.

Version : SDK: 1.27.9

ignoreNoCookieAccess🔗

ignoreNoCookieAccess: boolean

Optional

Ignore the cookie access alert when third-party cookies are blocked by the user’s browser. If you set this to true, the embedded iframe behaviour persists even in the case of a non-logged-in user.

default : false

inPopup🔗

inPopup: boolean

Optional

[SSO] For SSO Authentication, if inPopup is set to true, it will open the SAML auth flow in a popup, instead of redirecting the browser in place.

Need to use this with authTriggerContainer. Or manually trigger the AuthEvent.TRIGGER_SSO_POPUP event on a user interaction.

Version : SDK: 1.18.0

default : false

logLevel🔗

logLevel: LogLevel

Optional

Suppress or show specific types of logs in the console output. For example, LogLevel.ERROR shows only Visual Embed SDK and ThoughtSpot application errors and suppresses other logs such as warnings, information alerts, and debug messages in the console output.

Version : SDK: 1.26.7 | ThoughtSpot: 9.10.0.cl

default : LogLevel.ERROR

init({
  ...embedConfig,
  logLevel: LogLevel.SILENT
})

loginFailedMessage🔗

loginFailedMessage: string

Optional

This message is displayed in the embedded view when a user login fails.

Version : SDK: 1.10.1 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw

noRedirect🔗

noRedirect: boolean

Optional

[SSO] For SSO Authentication, if noRedirect is set to true, it will open the SAML auth flow in a popup, instead of redirecting the browser in place.

Deprecated : This option is deprecated.

default : false

numberFormatLocale🔗

numberFormatLocale: string

Optional

Overrides default/user preferred locale for number formatting

Version : SDK: 1.28.4 | ThoughtSpot: 10.0.0.cl, 9.5.0.sw

password🔗

password: string

Optional

[Basic] The ThoughtSpot login password corresponding to the username

Warning: This feature is primarily intended for developer testing. It is strongly advised not to use this authentication method in production.

pendoTrackingKey🔗

pendoTrackingKey: string

Optional

Pendo API key to enable Pendo tracking to your own subscription, the key is added as an additional key to the embed, as per this document.

Version : SDK: 1.27.0 | ThoughtSpot: 9.8.0.cl

queueMultiRenders🔗

queueMultiRenders: boolean

Optional

When there are multiple objects embedded, queue the rendering of embedded objects to start after the previous embed’s render is complete. This helps improve performance by decreasing the load on the browser.

Version : SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1

default : false

redirectPath🔗

redirectPath: string

Optional

[SSO] For SSO Authentication, one can supply an optional path param; This will be the path on the host origin where the SAML flow will be terminated.

Eg: "/dashboard", "#/foo" [Do not include the host]

Version : SDK: 1.10.2 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw

shouldEncodeUrlQueryParams🔗

shouldEncodeUrlQueryParams: boolean

Optional

Boolean to define if the query parameters in the ThoughtSpot URL should be encoded in base64. This provides additional security to ThoughtSpot clusters against cross-site scripting attacks.

default : false

suppressErrorAlerts🔗

suppressErrorAlerts: boolean

Optional

If passed as true all alerts will be suppressed in the embedded app.

Version : SDK: 1.26.2 | ThoughtSpot: *

suppressNoCookieAccessAlert🔗

suppressNoCookieAccessAlert: boolean

Optional

Suppress cookie access alert when third-party cookies are blocked by the user’s browser. Third-party cookie blocking is the default behaviour on some web browsers like Safari. If you set this attribute to true, you are encouraged to handle noCookieAccess event, to show your own treatment in this case.

default : false

suppressSageEmbedBetaWarning🔗

suppressSageEmbedBetaWarning: boolean

Optional

Hide beta alert warning message for SageEmbed.

suppressSearchEmbedBetaWarning🔗

suppressSearchEmbedBetaWarning: boolean

Optional

Hide the beta alert warning message for SearchEmbed.

Version : SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1.sw

thoughtSpotHost🔗

thoughtSpotHost: string

The ThoughtSpot cluster hostname or IP address.

useEventForSAMLPopup🔗

useEventForSAMLPopup: boolean

Optional

Specify that we want to use the AuthEvent.TRIGGER_SSO_POPUP event to trigger SAML popup. This is useful when you want to trigger the popup on a custom user action.

username🔗

username: string

Optional

[AuthServer / Basic] The user name of the ThoughtSpot user. This attribute is required for trusted authentication.

waitForCleanupOnDestroy🔗

waitForCleanupOnDestroy: boolean

Optional

Wait for the cleanup to be completed before destroying the embed.

Version : SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl

default : false

Methods🔗

getAuthToken🔗

getAuthToken() : Promise< string >

[AuthServer] A function that invokes the trusted authentication endpoint and returns a Promise that resolves to the auth token string. For trusted authentication, the authEndpoint or getAuthToken attribute is required.

It is advisable to fetch a new token inside this method and not reuse the old issued token. When auth expires this method is called again and if it is called with an older token, the authentication will not succeed.

Returns

Promise< string >

Defined in : types.ts

EmbedConfig

Index🔗

Properties🔗

additionalFlags🔗

authEndpoint🔗

authTriggerContainer🔗

authTriggerText🔗

authType🔗

autoLogin🔗

blockNonEmbedFullAppAccess🔗

callPrefetch🔗

cleanupTimeout🔗

currencyFormat🔗

customActions🔗

customVariablesForThirdPartyTools🔗

customizations🔗

dateFormatLocale🔗

detectCookieAccessSlow🔗

disableFullscreenPresentation🔗

disableLoginFailurePage🔗

disableLoginRedirect🔗

disablePreauthCache🔗

disableSDKTracking🔗

ignoreNoCookieAccess🔗

inPopup🔗

logLevel🔗

loginFailedMessage🔗

noRedirect🔗

numberFormatLocale🔗

password🔗

pendoTrackingKey🔗

queueMultiRenders🔗

redirectPath🔗

shouldEncodeUrlQueryParams🔗

suppressErrorAlerts🔗

suppressNoCookieAccessAlert🔗

suppressSageEmbedBetaWarning🔗

suppressSearchEmbedBetaWarning🔗

thoughtSpotHost🔗

useEventForSAMLPopup🔗

username🔗

waitForCleanupOnDestroy🔗

Methods🔗

getAuthToken🔗