What's new in the Embedding SDK

In each release, changes are made to make the MicroStrategy SDK more powerful and easier to use.

Strategy September 2026

• Support currentPage.targetFolder for embedded Library page
  • Navigate directly to a specific folder on the Content Discovery page when embedding the Library home page.

Strategy August 2026

• Introduce pageSelectionMode to enable page selection on a dashboard consumption page.

Strategy ONE July 2026

• Support attribute qualification filter
  • Users can apply an attribute qualification filter in the Native Embedding SDK.

Strategy ONE June 2026

• Support native incremental rendering
  • Use the new MstrDossier.addWidgets() API to enable incremental rendering on an existing MstrDossier instance.

Strategy ONE April 2026

• New property embeddingHostPortal
  • Add the embeddingHostPortal property to all embedding APIs to replace the host in shared dashboard links, with the actual dashboard link passed as the mstrLibraryLink query parameter.
• Support embedding panel stacks
  • The user can embed a panel stack as a single component in Native Embedding SDK.
• New feature flag ENABLE_REST_API_CACHE
  • Add a feature flag to control whether REST API results are cached to improve performance.

Strategy ONE January 2026

• Support metric qualification filter
  • The user can apply filter for the metric qualification filter in Native Embedding SDK.

Strategy ONE December 2025

• Support multiple instances for one dashboard
  • Use the new forceCreateNewInstance parameter in the MstrEnvironment.loadDossier() API to support creating multiple instances for one dashboard in Native Embedding SDK.
• Support using bookmarks to show multiple copies of one visualization
  • Support to use bookmark APIs to create, delete, and get bookmarks;
  • Support using bookmarkId to load a MstrDossier object based on a bookmark in the MstrEnvironment.loadDossier() API.
• Support applying values for value parameter filter
  • Support the value parameter filter in the MstrDossier.applyFilter() and MstrDossier.applyFilters() API.

Strategy ONE September 2025

• Support dataset ids and pause mode in embedded authoring
  • Support to input dataset ids when embedding a new dossier authoring page, and set pause mode in the API microstrategy.dossier.create() in iframe Embedding SDK.

Strategy ONE August 2025

• Support Dashboard Instance Id in goToPage()
  • Support to input the dashboard instance id in the API EmbeddingContext.goToPage() in iframe Embedding SDK.

Strategy ONE July 2025

• Get the dashboard instance ID
  • Support to get the dashboard instance id via the new API MstrDossier.getDossierInstanceId() in Native Embedding SDK.
• Add a new parameter to improve performance
  • Add suppressAutoRecovery parameter in microstrategy.embeddingComponent.environments.create() function to improve the initial load performance.
• Add a new feature flag to get performance profiles
  • Add a new feature flag window.microstrategy.nativeEmbedding.featureFlags.enableProfile to record the performance profiles in Native Embedding SDK.

Strategy ONE June 2025

• Information Window
  • Introduce the Information Window feature in Native Embedding SDK to enhance data visualization interactivity by providing contextual details in a dynamic overlay.
• Retrieve and apply filters
  • Support the Attribute/Metric selector in MstrDossier.applyFilter() and MstrDossier.applyFilters() in Native Embedding SDK.

Strategy ONE April 2025

• Properties for an embedded Library home page.
  • Introduce settings.filter.projects to filter the library to display content from a specific project.

Strategy ONE March 2025

• Embed MicroStrategy document consumption page.
  • Provide API to embed a document consumption page.
• Embed MicroStrategy dashboard consumption page.
  • Introduce panelSelectionMode to enable panel selection on a dashboard consumption page.
• Native Embedding SDK - Retrieve and apply filters
  • Introduce MstrDossier.applyFilters to apply multiple filters in one API.
• A new embedding context API.
  • Introduce a new API, selectPanels(panelKeys), to programmatically select panels on the dossier consumption page.

MicroStrategy ONE December 2024

• Embed MicroStrategy dashboard consumption page.
  • Introduce disableGroupSelection property to disable group selection in the component selection mode on Microstrategy dashboard consumption page.

MicroStrategy ONE September 2024

• Embed MicroStrategy dashboard consumption page.

  • Introduce enablePageSelection property to customize displaying page selectors in the TOC panel of Microstrategy dashboard consumption page.

• The customized UI settings in Embedding SDK.

  • Introduce customUi object property dockedToc to customize default values of isOpen and isDocked of the TOC panel in the UI of Microstrategy dashboard consumption page.

• Embed Dashboard Visualizations with Native Embedding SDK.

  • Introduce AbortController support to cancel MstrDossier.refresh() calls.

• Native Embedding MstrEnvironment Class

  • Introduce optional applicationId input parameter for MstrEnvironment.loadDossier() and MstrEnvironment.loadBot().
  • Introduce MstrEnvironment.getAuthToken() function.

• Properties for an embedded MicroStrategy Library home page.

  • Change the available values of currentPage.key according to the Library UI change and new API functionalities: Remove 'all', 'myContent', 'favorites' and 'recents'; add 'home' and 'contentDiscovery'.

MicroStrategy ONE June 2024

• Embed MicroStrategy bot consumption page.
  • Deprecate botConsumption object property snapshot.enabled to customize UI of the bot consumption page.
  • Deprecate botConsumption object property topicsPanel.enabled to customize UI of the bot consumption page.
  • Introduce botConsumption object property aiBot to customize UI of the bot consumption page.
  • Introduce customUi object property theme to customize UI of Microstrategy Library including bot consumption page.
  • Introduce botConsumption boolean property disableHyper to customize if you want to disable hyper extension highlight service in bot consumption page.
• Bot consumption page APIs.
  • You can call new APIs on the bot consumption page to interact with Microstrategy bot.
• New dashboard consumption page APIs.
  • You can call the dashboard APIs via the embeddingContext.dossierConsumption object on a dashboard consumption page.
• A new embedding context API.
  • You can call the new API embeddingContext.goToPage(page) to navigate to an arbitrary page on the OOTB Library.
• New OAuth APIs for SAML and OIDC login.
  • You can call the new APIs to simplify the original SAML or OIDC workflow.

MicroStrategy ONE March 2024

• Rename 'dossier' into 'dashboard'.
• Embed Bot Visualizations with Native Embedding SDK.
  • You can use the new Embedding SDK APIs to embed the visualizations on a bot consumption page.

2021 Update 12

Embed MicroStrategy bot consumption page.

• You can use a new Embedding SDK API to embed a bot consumption page. The user also could do some UI customizations.

2021 Update 11

• Embed MicroStrategy dashboard consumption page.
  • You can use a new Embedding SDK API to embed a dashboard consumption page, in which we support the user to navigate between the dashboard and the homepage.
• Dashboard consumption page APIs.
  • You can call new APIs on the dashboard consumption page to get and set the selected components.

2021 Update 9

The Native Embedding SDK.

• You can use the Native Embedding SDK to embed visualizations from separate containers to improve performance.
• Users can interact with the embedded visualization.
• Users can use APIs to perform manipulations such as filtering.

2021 Update 8

• Embed MicroStrategy report page.
  • Users can embed MicroStrategy report consumption page.
  • Users can control the visibility of the navigation bar of the report consumption page.
• Ability to customize dashboard pages from embedding Library home page
• Ability to customize Library home page from embedding dashboard page

2021 Update 7

Embed MicroStrategy Library home page.

• Users can embed MicroStrategy Library home page and use any child page accessed from the sidebar.
• Users can control the visibility of the navigation bar and the sidebar of the library home page.

2021 Update 4

• Enhancements to authoring an embedded dashboard.
  • Control the display of items in the authoring toolbar.
  • Control the display of authoring panels.
  • Support for creating a new dashboard.
• Show or hide all entries for a subscription.

2021 Update 3

• Author an embedded dashboard.
• Enable the selection of attribute elements.

2021 Update 2

• Interact with panel stacks in dossiers.
• Embed a single visualization.

2021

• More updates in error handling.
• Apply multiple filters after a dashboard is rendered.
• Show or hide the shareDossier function.

2020 Update 3

Error handling.

2020 Update 2

A new method to remove an embedded dashboard.

2019

A new property, dossierFeature, allows you to customize dashboard features on the UI. Use the readOnly detailed property to enable or disable all context menus. This includes the visualization right-click context menu and the context menu on the top right of the visualization that includes such options as Export.

11.0

• A new property allows you to pass filters during dashboard execution.
• New properties allow you to customize features and the UI for an embedded dashboard.

10.9

The Embedding SDK was introduced in 10.9.

• This new SDK was added to the MicroStrategy Developer Library to support embedding MicroStrategy content in third-party web applications or portals.