Merge pull request #449 from thoughtspot/main

ShashiSubramanya · web-flow · commit 5734b6d57efe · 2026-04-02T15:27:37.000+05:30
docs publication
diff --git a/modules/ROOT/pages/api-changelog.adoc b/modules/ROOT/pages/api-changelog.adoc
@@ -8,6 +8,95 @@
 
 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.47.x, April 2026
+[width="100%" cols="1,4"]
+|====
+|[tag greenBackground]#NEW FEATURE# a| **Spotter chat history sidebar customization**
+
+The SDK introduces the `SpotterSidebarViewConfig` interface and the `spotterSidebarConfig` object with configuration controls to customize the appearance and contents of the chat history panel. Developers can use the  following properties in the `spotterSidebarConfig` object to enable or disable chat history panel and customize the contents of the sidebar when enabled:
+
+* `enablePastConversationsSidebar` +
+Controls the visibility of the past conversations sidebar panel. The chat history panel is disabled by default in embed view. When this property in `spotterSidebarConfig` is specified, it takes precedence over the standalone `enablePastConversationsSidebar` setting, which is deprecated from v1.47.0.
+
+* `spotterSidebarTitle` +
+Allows adding custom title text for the sidebar header.
+
+* `spotterSidebarDefaultExpanded` +
+Sets the default state of the sidebar to expanded or collapsed view.
+
+* `spotterChatRenameLabel` +
+Allows setting a custom label for the **Rename** action in the conversation edit menu.
+
+* `spotterChatDeleteLabel` +
+Allows setting a custom label for the **Delete** action in the conversation edit menu.
+
+* `spotterDeleteConversationModalTitle` +
+Allows editing the title text of the chat delete confirmation modal.
+
+* `spotterPastConversationAlertMessage` +
+Sets a custom message text for the past conversation banner alert. Defaults to the translated alert message.
+
+* `spotterBestPracticesLabel` +
+Allows customizing the label for the best practices button in the sidebar footer.
+
+* `spotterDocumentationUrl` +
+The best practices documentation link shown in the sidebar footer. You can customize the link by specifying the full URL.
+
+* `spotterConversationsBatchSize` +
+Sets the number of conversations to fetch per batch when loading conversation history. Default is `30`.
+
+* `spotterNewChatButtonTitle` +
+Allows customizing the title text for the **New chat** button in the sidebar.
+
+|[tag redBackground]#DEPRECATED# a| **Standalone `enablePastConversationsSidebar` attribute in Spotter embed**
+
+The standalone `enablePastConversationsSidebar` property on `SpotterEmbedViewConfig` and `AppViewConfig` is deprecated from SDK 1.47.0 and ThoughtSpot 26.4.0.cl.
+
+Use `enablePastConversationsSidebar` in the `spotterSidebarConfig` instead. When both are defined, the property in the `spotterSidebarConfig` object takes precedence.
+
+[source,javascript]
+----
+// Deprecated
+enablePastConversationsSidebar: false,
+
+// Recommended
+spotterSidebarConfig: {
+    enablePastConversationsSidebar: true,
+    //... other config properties
+}
+----
+
+|[tag greenBackground]#NEW FEATURE# a| **Spotter chat UI branding**
+
+The SDK introduces the `SpotterChatViewConfig` interface for customizing branding in Spotter tool response cards. You can pass these parameters as the `spotterChatConfig` object properties in `SpotterEmbed`, `AppEmbed`, or `LiveboardEmbed` where Spotter interface is used.
+
+* `hideToolResponseCardBranding` +
+When set to `true`, hides the ThoughtSpot logo and icon in tool response cards. The branding label prefix is controlled separately via `toolResponseCardBrandingLabel`. Default value is `false`.
+
+* `toolResponseCardBrandingLabel` +
+Custom label to replace the `ThoughtSpot` prefix in tool response cards. Set to an empty string (`''`) to hide the prefix entirely.
+
+[NOTE]
+====
+These settings do not affect the external MCP tool branding.
+====
+
+|[tag greenBackground]#NEW FEATURE# a|**Liveboard embed enhancements**
+
+Personalized Liveboard view::
+
+The `personalizedViewId` property allows embedding a saved personalized view of a Liveboard. A personalized view is a saved configuration that includes specific filter selections and changes applied by a user. To embed a personalized view of Liveboard, specify the GUID of the saved personalized view to load along with `liveboardId`.
+
+Centralized Liveboard filter setting::
+
+When set to `true`, the `isCentralizedLiveboardFilterUXEnabled` enables displaying a unified modal to manage and update multiple filters at once, replacing the older individual filter interactions. This feature is disabled by default on ThoughtSpot Embedded instances.
+
+|[tag greenBackground]#NEW FEATURE#  a|**Option to include current period in rolling date filters**
+
+If the current period inclusion in rolling date filters feature is enabled on your instance, the rolling date filters options such as **Last <N> <period>** and **Next <N> <period>** for the Liveboards and Answers in the embed view will allow you to include current period. For example, when you define a date range such as "Last 2 months", the date filter interface displays the **Include this month** checkbox.
+To disable this feature, use the `isThisPeriodInDateFiltersEnabled` setting. To hide, show, or disable this option in the embed view, use the action ID, `Action.IncludeCurrentPeriod`.
+|====
+
 == Version 1.46.x, March 2026
 
 [width="100%" cols="1,4"]
diff --git a/modules/ROOT/pages/deprecated-features.adoc b/modules/ROOT/pages/deprecated-features.adoc
@@ -14,7 +14,11 @@ 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#v1-v2-exp-fullApp-embed[V1 and V2 UI experience in full application embedding]|ThoughtSpot Cloud 26.8.0.cl and later | February 2026 | August 2026
+a|xref:deprecated-features.adoc#PNGFlowDeprecation[Select PNG export options] a|ThoughtSpot Cloud 26.4.0.cl and later | April 2026 | August 2026
+a|xref:deprecated-features.adoc#variableApis[Variable APIs] a|ThoughtSpot Cloud 26.4.0.cl and later | April 2026 | November 2026
+a|xref:deprecated-features.adoc#metadataParameterization[Metadata parameterization] a|ThoughtSpot Cloud 26.4.0.cl and later | April 2026 | November 2026
+a|xref:deprecated-features.adoc#SagePrivilegeDeprecation[PREVIEW_THOUGHTSPOT_SAGE privilege] 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
@@ -81,6 +85,68 @@ a|xref:deprecated-features.adoc#_deprecated_parameter_in_rest_api_v2_0_authentic
 ||||
 |=====
 
+[#v1-v2-exp-fullApp-embed]
+== V1 and V2 navigation and home page experience in full app embed
+Starting with ThoughtSpot 26.8.0.cl, the V3 navigation and home page experience will be set as the default UI experience in full application embedding. The V1 and V2 navigation and home page experience will be deprecated and will no longer be supported.
+
+Impact on your instance::
+If your embed currently uses the Classic (v1) or v2 navigation and home page experience, the UI will be automatically upgraded to the V3 experience. This change applies to all deployments embedding the full ThoughtSpot application.
+
+Recommended action::
+If your embed deployments are still using the legacy experience modes, we recommend that you enable the V3 navigation and home page experience in your development environments and evaluate the changes. For information on the features available in V3 experience mode, refer to the xref:full-app-customize.adoc[Full application embedding documentation].
+
+[#PNGFlowDeprecation]
+== Deprecating select options in PNG export
+The `include_cover_page` and `include_filter_page` options for the `POST /api/rest/2.0/report/liveboard` endpoint are now deprecated for PNG downloads.
+
+The Liveboard Report API has improved PNG export options which generate high-quality PNGs that closely match the Liveboard experience. It supports `image_resolution` (up to 3840px wide), `image_scale` (zoom), and allows developers to export a specific tab instead of stitching all tabs vertically.
+
+Impact on your instance::
+* For current users, starting with the ThoughtSpot 26.8.0.cl release, API calls to the `POST /api/rest/2.0/report/liveboard` endpoint for PNG exports with `include_cover_page` and `include_filter_page` will result in an error.
+** If you are currently using the legacy PNG export flow with `include_cover_page` and `include_filter_page`, it will continue to work without interruption until the ThoughtSpot 26.8.0.cl release.
+** If you have enabled the new PNG export flow with `image_resolution`, `image_scale`, and `include_header` , API calls to the `POST /api/rest/2.0/report/liveboard` endpoint for PNG exports with legacy options will result in an error.
+* For new users, API calls to the `POST /api/rest/2.0/report/liveboard` endpoint for PNG exports with `include_cover_page` and `include_filter_page` will result in an error. Use the new PNG export options.
+//If you still have to use these options for your ThoughtSpot instance contact ThoughtSpot support to revert to these legacy settings.
+
+For more information on PNG export, see xref:data-report-v2-api.adoc#_liveboard_report_api[Liveboard Report API]
+
+Recommended action::
+* We recommend transitioning to the new flow for PNG exports, as the `include_cover_page` and `include_filter_page` attributes will be removed in a future release.
+* Contact ThoughtSpot support to enable the new settings for PNG downloads on your ThoughtSpot instance.
+* PNG download now supports exporting only one tab at a time. If the `tab_identifier` is not specified, the first tab will be downloaded.
+
+[#variableApis]
+== Variable APIs for update and delete operations
+
+The `/api/rest/2.0/template/variables/{identifier}/delete` and `/api/rest/2.0/template/variables/update-values` endpoints are deprecated in 26.4.0.cl and will be removed from ThoughtSpot in an upcoming release:
+
+Impact on your instance::
+Your existing implementation will continue to work until further notice. However, these endpoints will be removed from ThoughtSpot in a future release. Therefore, ThoughtSpot recommends using the following new API endpoints: +
+** `POST /api/rest/2.0/template/variables/{identifier}/update-values` +
+Assigns multiple values to variables and sets the scope for variable values in a single API request.
+** `POST /api/rest/2.0/template/variables/delete` +
+Deletes one or more variables in a single API request.
+
+Recommended action::
+If you are using legacy variable update and delete APIs, update your workflows to use the new API endpoints. Test the changes in your development environment before updating your production integrations.
+
++
+For more information, see link:https://developers.thoughtspot.com/docs/26.4.0.cl?pageid=variables[Variables documentation, window=_blank].
+
+[#metadataParameterization]
+== Metadata parameterization API
+
+The `/api/rest/2.0/metadata/parameterize` endpoint is deprecated in 26.4.0.cl and will be removed in a future release.
+
+Impact on your instance::
+Your existing implementation will continue to work until further notice. However, ThoughtSpot recommends using the `/api/rest/2.0/metadata/parameterize-fields` for metadata parameterization.
+
+Recommended action::
+If you are using the legacy API endpoint, update your workflows to use the new API endpoint. Test the changes in your development environment before updating your production integrations.
+
++
+For more information, see link:https://developers.thoughtspot.com/docs/26.4.0.cl?pageid=parameterize-metadata[Metadata parameterization documentation, window=_blank].
+
 [#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.
@@ -92,7 +158,7 @@ Impact on your instance::
 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]
 == 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.
 
@@ -114,7 +180,7 @@ Recommended action::
 * If your instance has Worksheets, verify whether they are replaced with Models after your instance is upgraded to 10.12.0.cl.
 * If you are importing Worksheet TML, the import operation will fail. Therefore, ThoughtSpot recommends converting Worksheets to Models and then importing Model TMLs to ThoughtSpot.
 * Update your CI/CD and Git workflows to use Model TMLs instead of Worksheets.
-* In REST APIs, the subtypes of `LOGICAL_TABLE`  objects may still be referred to as Worksheet. However, these subtypes  imply Models. When you specify subtype `WORKSHEET`, the API will include Models in the response or operation.
+* In REST APIs, the subtypes of `LOGICAL_TABLE` objects may still be referred to as Worksheet. However, these subtypes imply Models. When you specify subtype `WORKSHEET`, the API will include Models in the response or operation.
 * You may find the "Worksheet" terminology in the Visual Embed SDK configuration properties and feature flags; for example, the `worksheetId` property in Spotter embed. However, when configuring these settings, use the Model object and its associated properties.
 
 [#restApiPlayground]
@@ -131,7 +197,7 @@ When the REST API v1 Playground is no longer available in the ThoughtSpot UI, us
 [#SageDeprecationNotice]
 == Sage and Ask Sage deprecation
 
-The Sage Search (the legacy Natural Language Search interface) and *Ask Sage* features are deprecated from 10.11.0.cl and will be removed from the product in December 2025.
+The Sage Search (the legacy Natural Language Search interface) and *Ask Sage* features are deprecated starting from 10.11.0.cl and will be removed from the product in December 2025.
 Along with this, the xref:SageEmbed.adoc[SageEmbed] library in the Visual Embed SDK will also be deprecated.
 
 //with no new enhancements or bug fixes supported after July 2025.
@@ -260,15 +326,15 @@ If you are embedding ThoughtSpot without the SDK, you can switch to Visual Embed
 
 == Deprecated parameter in REST API v2.0 authentication token endpoints
 
-The `jwt_user_options` object property in `/api/rest/2.0/auth/token/full` and `/api/rest/2.0/auth/token/object` is deprecated.
+The `jwt_user_options` object property in `/api/rest/2.0/auth/token/full` and `/api/rest/2.0/auth/token/object` endpoints is deprecated.
 
 Effective from::
 * ThoughtSpot Cloud 9.12.0.cl
 * ThoughtSpot Software 10.1.0.sw
 
 === Recommended action
 Use the `user_parameters` property available with the `/api/rest/2.0/auth/token/full` and `/api/rest/2.0/auth/token/object` endpoints to define security entitlements to a user session. +
-For more information, see xref:abac-user-parameters.adoc[ABAC via token][beta betaBackground]^Beta^.
+For more information, see xref:abac-user-parameters.adoc[ABAC via token ^Beta^].
 
 == Deprecated parameters in Version Control APIs
 
@@ -314,4 +380,4 @@ Recommended action::
 For information about REST API v2.0 endpoints, refer to the following articles and visit the link:{{navprefix}}/restV2-playground?apiResourceId=http%2Fgetting-started%2Fintroduction[REST API v2 Playground].
 
 * xref:rest-api-v2-getstarted.adoc[REST API v2.0]
-* xref:rest-api-v1v2-comparison.adoc[REST API v1 and v2.0 comparison]
+* xref:rest-api-v1v2-comparison.adoc[REST API v1 and v2.0 comparison]
diff --git a/modules/ROOT/pages/rest-apiv2-changelog.adoc b/modules/ROOT/pages/rest-apiv2-changelog.adoc
@@ -8,6 +8,10 @@
 
 This changelog lists the features and enhancements introduced in REST API v2.0. For information about new features and enhancements available for embedded analytics, see xref:whats-new.adoc[What's New].
 
+== Version 26.4.0.cl
+
+For information about new REST API features and enhancements, see link:https://developers.thoughtspot.com/docs/26.4.0.cl?pageid=rest-v2-changelog[26.4.0.cl Developer Documentation, window=_blank].
+
 == Version 26.3.0.cl, March 2026
 
 === Webhook APIs
diff --git a/modules/ROOT/pages/whats-new.adoc b/modules/ROOT/pages/whats-new.adoc
@@ -8,6 +8,10 @@
 
 This page lists new features, enhancements, and deprecated functionality in ThoughtSpot Embedded instances.
 
+== Version 26.4.0.cl
+
+ThoughtSpot Cloud 26.4.0.cl release version is now available! For information about the new features and enhancements introduced in this release, see link:https://developers.thoughtspot.com/docs/26.4.0.cl?pageid=whats-new[26.4.0.cl Developer Documentation, window=_blank].
+
 == Version 26.3.0.cl
 
 === ThoughtSpot integration with Amazon S3 storage for webhook delivery
diff --git a/src/components/VersionIframe/index.scss b/src/components/VersionIframe/index.scss
@@ -6,6 +6,7 @@
 }
 
 .version-iframe {
+    all: unset;
     width: 100%;
     height: 100%;
 }
diff --git a/src/configs/doc-configs.js b/src/configs/doc-configs.js
@@ -22,8 +22,8 @@ module.exports = {
         //   'https://developers.thoughtspot.com/docs/26.3.0.cl?pageid=whats-new'
         // - GA: ' /docs/whats-new'
         //linkHref: '/docs/whats-new',
-        linkHref: '/docs/26.3.0.cl?pageid=whats-new',
-        linkText: 'Version 26.3.0.cl',
+        linkHref: '/docs/26.4.0.cl?pageid=whats-new',
+        linkText: 'Version 26.4.0.cl',
         openInNewTab: true,
     },
     TYPE_DOC_PREFIX: 'typedoc',
@@ -47,11 +47,17 @@ module.exports = {
         DEV: 'dev',
     },
     VERSION_DROPDOWN: [
-	{
+	    {
             label: '26.3.0.cl',
             link: ' ',
             subLabel: 'Cloud (Latest)',
             iframeUrl: 'https://developer-docs-26-3-0-cl.vercel.app/docs/',
+        },
+	    {
+            label: '26.4.0.cl',
+            link: '26.4.0.cl',
+            subLabel: 'Coming soon',
+            iframeUrl: 'https://developer-docs-26-4-0-cl.vercel.app/docs/',
         },
         {
             label: '26.2.0.cl',

Original file line number	Diff line number	Diff line change
`@@ -6,6 +6,7 @@`
`6`	`6`	`}`
`7`	`7`
`8`	`8`	`.version-iframe {`
	`9`	`+ all: unset;`
`9`	`10`	`width: 100%;`
`10`	`11`	`height: 100%;`
`11`	`12`	`}`