Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
f4427e4
link override v2
rani2655 Feb 17, 2026
e0e9390
deprecation for sage privilege
rani2655 Feb 19, 2026
b371d60
deprecation edits
rani2655 Feb 23, 2026
382f99f
changed docconfig to 26.3
rani2655 Feb 23, 2026
79329ed
changed the lb styling flag
rani2655 Feb 24, 2026
598470d
changes for Spotter privilege
rani2655 Feb 24, 2026
8ab458b
SCAL-215583
ShashiSubramanya Feb 24, 2026
c3d9491
link override updates
rani2655 Feb 25, 2026
48d3c35
changes for override link settings
rani2655 Feb 25, 2026
c7b441c
26.3 updates
rani2655 Feb 24, 2026
132efae
edits for 26.3
ShashiSubramanya Feb 26, 2026
0f3746a
version number is banner
ShashiSubramanya Feb 26, 2026
9140538
edit
rani2655 Feb 26, 2026
1e3ac09
webhook edits
ShashiSubramanya Feb 26, 2026
6d8f7b3
typo fixes
ShashiSubramanya Feb 27, 2026
b1ebe65
added changelog for lb sdk flags
rani2655 Feb 27, 2026
8741fa5
SCAL-280604 and SCAL-265929
ShashiSubramanya Feb 27, 2026
0c8fa43
csp info removal and other fixes
ShashiSubramanya Feb 27, 2026
9057247
00review edits
ShashiSubramanya Feb 27, 2026
7f935b1
SCAL-284461 updates
ShashiSubramanya Feb 27, 2026
ef9a0b0
SCAL-294970 fixes
ShashiSubramanya Feb 27, 2026
42fa1a9
typo fixes
ShashiSubramanya Feb 27, 2026
f7ee501
typo fixes
ShashiSubramanya Feb 27, 2026
ab63203
0cp
ShashiSubramanya Feb 27, 2026
31c3c78
edits and typo fixes
ShashiSubramanya Feb 28, 2026
436ff43
edits
ShashiSubramanya Feb 28, 2026
231ee9e
edits
ShashiSubramanya Feb 28, 2026
b07b668
edits
ShashiSubramanya Feb 28, 2026
9621034
edits
ShashiSubramanya Feb 28, 2026
0461110
Update abac_rls-variables.adoc
bryanthowell-ts Feb 17, 2026
b6d69d6
Update abac_rls-variables.adoc
bryanthowell-ts Feb 17, 2026
7e7d382
Update abac_rls-variables.adoc
bryanthowell-ts Feb 17, 2026
1107b75
Update abac_rls-variables.adoc
bryanthowell-ts Feb 17, 2026
cb38564
Update abac_rls-variables.adoc
bryanthowell-ts Feb 17, 2026
d2c1691
Update abac_rls-variables.adoc
bryanthowell-ts Feb 17, 2026
80405d7
minor edits and typo fixes
ShashiSubramanya Feb 27, 2026
4c80fa5
Merge branch '26.3.0.cl' into overridelink
rani2655 Mar 2, 2026
bda89f2
edits to sdk changelog
rani2655 Mar 2, 2026
8f0641c
Merge pull request #414 from thoughtspot/overridelink
rani2655 Mar 2, 2026
8a7171b
Merge pull request #413 from thoughtspot/deprecation-sage
rani2655 Mar 2, 2026
40ec659
edited lb embed page
rani2655 Mar 5, 2026
d590142
edited lb embed page
rani2655 Mar 5, 2026
6a28b43
edited lb embed page
rani2655 Mar 5, 2026
0d8037e
edited lb embed page 1
rani2655 Mar 5, 2026
afcec24
edited lb embed page 2
rani2655 Mar 5, 2026
90d8129
edited lb embed page 3
rani2655 Mar 5, 2026
7134cc6
edited lb embed page 4
rani2655 Mar 5, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion modules/ROOT/pages/3rd-party-script.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
= Integrate external tools and allow custom scripts
= External tools and script integration
:toc: true
:toclevels: 2

Expand Down Expand Up @@ -52,6 +52,11 @@ image::./images/csp-script-domain.png[CSS script-src domain]
* The *CSP script-src domains* cannot be enabled and configured at the Org level. When configured, this setting will apply to all the Orgs configured on your instance.
====

=== Allow Websocket endpoints
If your tool uses WebSockets, add the tool’s `wss://` endpoint to the CSP and CORS allowlists in ThoughtSpot. This enables secure WebSocket connections from an embedded ThoughtSpot page to the tool's WebSocket endpoint without being blocked by the browser’s Content Security Policy.

Only hosts explicitly listed with `wss://` are permitted. You can add `wss://<host>` URL in the **Develop** > **Security Settings** page.

== Passing variables to the hosted script

To pass variables to the customer's hosted script, Visual Embed SDK provides the `customVariablesForThirdPartyTools` parameter. The `customVariablesForThirdPartyTools` is an object containing the variables that you wish to pass to the customer’s hosted JavaScript. These may include private information such as credentials or keys. The hosted JavaScript will access these variables via the `window.tsEmbed` object.
Expand Down
335 changes: 201 additions & 134 deletions modules/ROOT/pages/abac_rls-variables.adoc

Large diffs are not rendered by default.

76 changes: 65 additions & 11 deletions modules/ROOT/pages/api-changelog.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,67 @@

This changelog lists only the changes introduced in the Visual Embed SDK. For information about new features and enhancements available for embedded analytics, see xref:whats-new.adoc[What's New].

== Version 1.46.x, March 2026

[width="100%" cols="1,4"]
|====
|[tag redBackground]#DEPRECATED# a| **dataPanelV2**

The `dataPanelV2` parameter is deprecated and can no longer be used to switch between the classic and new data panel experience. By default, the new data panel v2 experience is enabled on all ThoughtSpot embedded instances.

|[tag greenBackground]#NEW FEATURE# a| **Spotter experience**
The SDK includes the following parameters, action IDs, and events to customize the Spotter embed experience.

Chat history sidebar customization::

//* `SpotterSidebarViewConfig` interface with configuration parameters for customizing the visibility and appearance of the chat history sidebar.
* `spotterSidebarConfig` properties for customizing the appearance and available options in the chat history sidebar.
* Action IDs for customizing the visibility and status of actions in the embedded Spotter interface:
** `Action.DataModelInstructions` for the data model instructions icon.
** `Action.SpotterSidebarHeader` for the chat history sidebar header
** `Action.SpotterSidebarFooter` for the chat history sidebar footer
** `Action.SpotterSidebarToggle` for the chat history toggle that expands or collapses the sidebar.
** `Action.SpotterNewChat` for the new chat icon in the chat history sidebar.
** `Action.SpotterPastChatBanner` for the banner in the chat history sidebar.
** `Action.SpotterChatMenu` for the chat menu component in the chat history sidebar.
** `Action.SpotterChatRename` for **Rename** action in the chat menu of a saved chat.
** `Action.SpotterChatDelete` for **Delete** action in the chat menu of a saved chat.
//** `Action.SpotterDocs` for best practices documentation icon in the chat history sidebar.

Events::
* `HostEvent.DataModelInstructions` +
Opens the Data Model instructions modal.
* `EmbedEvent.DataModelInstructions` +
Is emitted when a user clicks the Data Model instructions icon in the Spotter interface.
* `EmbedEvent.SpotterConversationRenamed` +
Is emitted when a user renames a saved chat.
* `EmbedEvent.SpotterConversationDeleted` +
Is emitted when a saved chat is deleted.
* `EmbedEvent.SpotterConversationSelected` +
Is emitted when a saved chat is selected in the chat history sidebar.

|[tag greenBackground]#NEW FEATURE# a| **Page context settings for host events**
The Visual Embed SDK includes the `getCurrentContext()` function to fetch the current context and route host events to a specific xref:ContextType.adoc[context type] in the embedded view.
For more information, see xref:events-context-aware-routing.adoc[Host events in multi-modal contexts].


|[tag greenBackground]#NEW FEATURE# | `enableLinkOverridesV2` +

Use this enhanced configuration to override ThoughtSpot URLs on hover or when opening in a new tab. This is recommended over the earlier `linkOverride` flag for a better user experience.

|[tag greenBackground]#NEW FEATURE# a| **Liveboard experience enhancements**

* The `isLiveboardXLSXCSVDownloadEnabled` attribute adds XLSX and CSV to the available Liveboard download formats.
* The `isGranularXLSXCSVSchedulesEnabled` attribute allows you to include the entire Liveboard, specific visualizations, or only tables and pivot tables in the XLSX and CSV schedules.
|====

== Version 1.45.0, February 2026

[width="100%" cols="1,4"]
|====
|[tag greenBackground]#NEW FEATURE# a|**Spotter enhancements **
|[tag greenBackground]#NEW FEATURE# a| **Spotter enhancements**

You can now embed the Spotter 3 experience in your application and use features such as Auto mode for automatic data model selection, Chat history, and a new chat prompt interface.
You can now embed the Spotter 3 experience in your application and use features such as Auto mode for automatic data model selection, chat history, and a new chat prompt interface.

* To enable the new chat prompt interface, set `updatedSpotterChatPrompt` to `true`.
* To use Auto mode, set the `worksheetId` to `auto_mode`.
Expand All @@ -37,7 +91,7 @@ On Spotter embed deployments running version 26.2.0.cl or later, the *Add to Coa

Styling and grouping::

* The `isLiveboardStylingAndGrouping` attribute, used for enabling the Liveboard styling and grouping feature, is now replaced with `isLiveboardMasterpiecesEnabled`. While your existing configuration with the deprecated attribute, `isLiveboardStylingAndGrouping` continues to work, we recommend switching to the new configuration setting.
* The `isLiveboardStylingAndGrouping` attribute, used to enable the Liveboard styling and grouping feature, is now replaced with `isLiveboardMasterpiecesEnabled`. While your existing configuration with the deprecated `isLiveboardStylingAndGrouping` attribute continues to work, we recommend switching to the new configuration setting.
* The following action IDs are now available to show, disable, or hide the grouping menu actions on a Liveboard:
** `Action.MoveToGroup` for the **Move to Group** menu action.
** `Action.MoveOutOfGroup` for the **Move out of Group** menu action.
Expand All @@ -51,21 +105,21 @@ For more information, see link:https://docs.thoughtspot.com/cloud/latest/securit
+
The `showMaskedFilterChip` setting is also available in full application embedding.

|[tag greenBackground]#NEW FEATURE# a|**Publishing objects**
|[tag greenBackground]#NEW FEATURE# a| **Publishing objects**

The following action IDs are available for the data publishing menu actions in the *Data workspace* page:

* `Action.Publish` for *Publish*
* `Action.ManagePublishing` for *Manange publishing*
* `Action.Unpublish` foe *Unpublish*
* `Action.ManagePublishing` for *Manage publishing*
* `Action.Unpublish` for *Unpublish*
* `Action.Parameterize` for *Parameterize*
|[tag greenBackground]#NEW FEATURE# a| **Error handling improvements**

To handle errors in the embedding workflows, the SDK includes the following features:

* `ErrorDetailsTypes` enum for categorizing error types, such as `API`, `VALIDATION_ERROR`, `NETWORK` error.
* `EmbedErrorCodes` enum with specific error codes for programmatic error handling
* `EmbedErrorDetailsEvent` interface for structured error event handling
* `ErrorDetailsTypes` enum for categorizing error types, such as `API`, `VALIDATION_ERROR`, and `NETWORK`.
* `EmbedErrorCodes` enum with specific error codes for programmatic error handling.
* `EmbedErrorDetailsEvent` interface for structured error event handling.

For more information, see link:https://developers.thoughtspot.com/docs/Enumeration_EmbedErrorCodes[EmbedErrorCodes] and link:https://developers.thoughtspot.com/docs/Enumeration_ErrorDetailsTypes[ErrorDetailsTypes].
|====
Expand All @@ -75,7 +129,7 @@ For more information, see link:https://developers.thoughtspot.com/docs/Enumerati
[width="100%" cols="1,4"]
|====

|[tag redBackground]#DEPRECATED# | ** Use `minimumHeight` instead of `defaultHeight` ** +
|[tag redBackground]#DEPRECATED# | **Use `minimumHeight` instead of `defaultHeight`** +

The `defaultHeight` parameter is deprecated in Visual Embed SDK v1.44.2 and later.
To set the minimum height of the embed container for ThoughtSpot components such as a Liveboard, use the `minimumHeight` attribute instead.
Expand All @@ -90,7 +144,7 @@ Allows configuring which API calls to intercept.
* `interceptTimeout` +
Sets the timeout duration for handling interception.
* `isOnBeforeGetVizDataInterceptEnabled` +
When set to true, it enables the use of `EmbedEvent.OnBeforeGetVizDataIntercept` event to emit and intercept search execution calls initiated by the users and implement custom logic or workflow to allow or restrict search execution.
When set to true, it enables use of `EmbedEvent.OnBeforeGetVizDataIntercept` to emit and intercept search execution calls initiated by users and implement custom logic or workflows to allow or restrict search execution.
* `EmbedEvent.ApiIntercept` +
Emits when an API call matching the conditions defined in `interceptUrls` is detected.

Expand Down
10 changes: 7 additions & 3 deletions modules/ROOT/pages/common/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@
** link:{{navprefix}}/tsembed[Embed ThoughtSpot in Web app]
*** Embed analytics
**** link:{{navprefix}}/embed-liveboard[Embed a Liveboard]
**** link:{{navprefix}}/embed-liveboard-copy[Embed a Liveboard NEW]
**** link:{{navprefix}}/embed-a-viz[Embed a visualization]
*** link:{{navprefix}}/embed-ai-search-analytics[Embed AI Search and Analytics]
**** link:{{navprefix}}/embed-spotter[Embed Spotter experience]
Expand Down Expand Up @@ -99,7 +100,8 @@
*** link:{{navprefix}}/action-config[Customize menus]
**** link:{{navprefix}}/actions[Action IDs in the SDK]
*** link:{{navprefix}}/events-app-integration[Events and app interactions]
**** link:{{navprefix}}/api-search-intercept[Intercept API and data fetch requests]
**** link:{{navprefix}}/context-aware-event-routing[HostEvents in multi‑modal contexts]
**** link:{{navprefix}}/api-search-intercept[API intercept and data fetch requests]
*** link:{{navprefix}}/custom-action-intro[Custom actions]
**** link:{{navprefix}}/customize-actions[Custom actions through the UI]
***** link:{{navprefix}}/custom-action-url[URL actions]
Expand Down Expand Up @@ -212,14 +214,16 @@ include::generated/typedoc/CustomSideNav.adoc[]
** link:{{navprefix}}/v1v2-comparison[REST v1 and v2.0 comparison]
** link:{{navprefix}}/graphql-guide[GraphQL API ^Beta^]
** link:{{navprefix}}/webhooks[Webhooks]
*** link:{{navprefix}}/webhooks-kpi[Webhook for KPI alerts]
*** link:{{navprefix}}/webhooks-lb-schedule[Webhook for Liveboard schedule events ^Beta^]
*** link:{{navprefix}}/webhooks-s3-integration[AWS S3 storage integration for Webhook delivery ^Beta^]
*** link:{{navprefix}}/webhooks-kpi[Webhook for KPI alerts]

* MCP Servers and Tools
** link:{{navprefix}}/SpotterCode[SpotterCode for IDEs]
*** link:{{navprefix}}/integrate-SpotterCode[Integrating SpotterCode]
*** link:{{navprefix}}/spottercode-prompting-guide[SpotterCode prompting guide]
** link:{{navprefix}}/mcp-integration[ThoughtSpot MCP server]
** link:{{navprefix}}/mcp-integration[Using ThoughtSpot MCP server]
*** link:{{navprefix}}/connect-mcp-server-to-clients[Connecting clients to MCP Server]

* link:{{navprefix}}/development-and-deployment[Deployment and integration]
** link:{{navprefix}}/development-and-deployment[Development and deployment]
Expand Down
2 changes: 1 addition & 1 deletion modules/ROOT/pages/customize-css-styles.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -189,7 +189,7 @@ Use the following variables to customize the Liveboard visualization groups and

[NOTE]
====
To enable this feature contact ThoughtSpot support and set `isLiveboardStylingAndGroupingEnabled` to `true` in the SDK .
To enable this feature contact ThoughtSpot support and set `isLiveboardMasterpiecesEnabled` to `true` in the SDK .
====

[width="100%" cols="7,7"]
Expand Down
27 changes: 22 additions & 5 deletions modules/ROOT/pages/customize-links.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -211,10 +211,15 @@ The default link format is `\https://{ThoughtSpot-Host}/#/\{path}`. If your host
https://www.mysite.com/{path}
----

+
You must also set the `linkOverride` to `true` in the Visual Embed SDK to override the link format of your embedded application pages and navigation links:
. Click *Save changes*.

== Override ThoughtSpot URLs

Link override settings allow embedded users to redirect native ThoughtSpot URLs to links within their host application. ThoughtSpot supports two Visual Embed SDK configurations for overriding links generated by ThoughtSpot. These settings work the same for multi-tenant ThoughtSpot embedded instances too.

You can set the `linkOverride` to `true` in the Visual Embed SDK to override the link format of your embedded application pages and navigation links. Once enabled, all links opened in a new tab via the right-click menu will show host application URLs.


+
[source,JavaScript]
----
const appEmbed = new AppEmbed(document.getElementById('ts-embed'), {
Expand All @@ -229,9 +234,21 @@ const appEmbed = new AppEmbed(document.getElementById('ts-embed'), {
appEmbed.render();
----

+
. Click *Save changes*.
Set `enableLinkOverridesV2` to `true` in the Visual Embed SDK. Once enabled, all links will display host application URLs when hovered over or opened in a new tab. ThoughtSpot recommends using this enhanced configuration for you link override settings.

[source,JavaScript]
----
const appEmbed = new AppEmbed(document.getElementById('ts-embed'), {
frameParams: {
width: '100%',
height: '100%',
},
pageId: Page.Home,
showPrimaryNavbar: true,
enableLinkOverridesV2: true,
});
appEmbed.render();
----

== Verify system-generated links

Expand Down
6 changes: 2 additions & 4 deletions modules/ROOT/pages/customize-nav-full-embed.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ a|
** A hamburger icon for the sliding navigation overlay
** Object search bar
** Help and profile icons +
The user profile includes *Admin settings* option, which is visible to users with administration privileges.
** Org switcher
* Left navigation
** A sliding left navigation panel controlled via the hamburger icon
Expand Down Expand Up @@ -70,14 +69,13 @@ To show or hide the application switcher.
| [tag greenBackground tick]#✓# Supported +
In V2 experience, hides the app selector in the top navigation bar.
| [tag greenBackground tick]#✓# Supported +
In the V3 experience, hides the app selection icons on the left navigation panel and the *Admin settings* option in the Profile menu.
In the V3 experience, hides the app selection icons on the left navigation panel.
| `disableProfileAndHelp` +
To show or hide the help and user profile icons in top navigation bar.
| [tag greenBackground tick]#✓# Supported
| [tag greenBackground tick]#✓# Supported +
Also hides or shows *Help* menu on the left navigation panel of the home page.
| [tag greenBackground tick]#✓# Supported +
Also hides the *Admin settings* menu in the profile dropdown.

| `hideOrgSwitcher` +
To show or hide the Org switcher.
Expand Down Expand Up @@ -263,7 +261,7 @@ If you want to include the help menu and link:https://docs.thoughtspot.com/cloud

By default, the help menu in the embedded view shows the legacy information center controlled using Pendo. To enable the new information center and add custom links, set `enablePendoHelp` to `false`.

To add custom links to the help menu, use the customization settings available on the **Admin settings** > **Help customization** page. For more information, refer to the link:https://docs.thoughtspot.com/cloud/latest/customize-help[ThoughtSpot Product Documentation].
To add custom links to the help menu, use the customization options in the **Admin settings** > **Help customization** page. For more information, refer to the link:https://docs.thoughtspot.com/cloud/latest/customize-help[ThoughtSpot Product Documentation].

[source,JavaScript]
----
Expand Down
13 changes: 13 additions & 0 deletions modules/ROOT/pages/deprecated-features.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ As ThoughtSpot applications evolve, some existing features will be deprecated an
[options='header']
|=====
|Feature|Impacted interface and release versions|Deprecation date |End of Support / removal from the product
a|xref:deprecated-features.adoc#SagePrivilegeDeprecation[`PREVIEW_THOUGHTSPOT_SAGE` privilege deprecation] a|ThoughtSpot Cloud 26.3.0.cl and later | March 2026 | September 2026
a|xref:deprecated-features.adoc#_answer_data_panel_classic_experience_deprecation[Answer Data panel classic experience] |ThoughtSpot Cloud 26.4.0.cl and later | April 2026 | August 2026
a|xref:deprecated-features.adoc#_worksheet_deprecation_and_removal[Worksheets] a| ThoughtSpot Cloud 10.4.0.cl and later
|November 2024 | September 2025
Expand Down Expand Up @@ -80,6 +81,18 @@ a|xref:deprecated-features.adoc#_deprecated_parameter_in_rest_api_v2_0_authentic
||||
|=====

[#SagePrivilegeDeprecation]
== `PREVIEW_THOUGHTSPOT_SAGE` privilege deprecation
The `PREVIEW_THOUGHTSPOT_SAGE` privilege is renamed to `CAN_USE_SPOTTER` with the ThoughtSpot 26.3.0.cl release version.

Impact on your instance::
* Both privileges remain supported until the ThoughtSpot 26.9.0.cl release, at which point `PREVIEW_THOUGHTSPOT_SAGE` will be removed.
* For existing ThoughtSpot instances which have enabled RBAC before the 26.3.0.cl release, there will be no automatic changes to the roles created using the `PREVIEW_THOUGHTSPOT_SAGE` privilege. However, the underlying privilege associated with such roles will be renamed to `CAN_USE_SPOTTER`.

Recommended action::
For ThoughtSpot instances which have enabled RBAC before the 26.3.0.cl release, the admins will have to create a role in accordance with the newer privilege name.


== Answer Data panel classic experience deprecation
The classic Data panel experience in Search and Answer pages will be deprecated in ThoughtSpot 26.4.0.cl release version. The new data panel experience, which provides a more intuitive layout with improved organization of data elements and features such as query sets and custom groups, will be the default data panel experience on all ThoughtSpot Embedded instances using Visual Embed SDK v1.41.1 or later.

Expand Down
2 changes: 1 addition & 1 deletion modules/ROOT/pages/embed-ai-analytics.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ __Available when the Spotter 2 experience is enabled on the instance__.
**When to use**: +
Use this version if you want to include agentic analytics and richer insights in your ThoughtSpot embedded app.

|Spotter Classic a| An early version of Spotter.
|Spotter Classic a| The early version of Spotter.

**Key features and user experience**: +

Expand Down
Loading