Skip to the content.

MicroStrategy Embedding SDK Samples

A collection of samples highlighting functionality and workflows of the Embedding SDK.

MicroStrategy Embedding SDK

MicroStrategy Embedding SDK allows you to quickly embed MicroStrategy Dossier into any web application in a responsive manner. It also allows you to control the behavior of your dossier using JavaScript code, such as navigation, filtering, manipulating the interfaces, event handling, etc.

For more information, please visit the official documentation of MicroStrategy Embedding SDK.

How to get MicroStrategy Embedding SDK?

MicroStrategy Embedding SDK is included in your MicroStrategy Library Server. You can use it from your web application using a URL like this:

https://[YOUR Environment]/MicroStrategyLibrary/javascript/embeddinglib.js

MicroStrategy REST API

MicroStrategy REST API is the backbone of MicroStrategy’s open architecture. MicroStrategy REST API is widely used in this project.

For more information about MicroStrategy REST API, please visit the official documentation and play with the live API Explorer.

Feature Showcase

This set of examples demonstrate specific features of Embedding SDK. Open each example to see what is possible with Embedding SDK. Make sure you check the source code for the implementation.

Features Examples
Dossier page customization, page navigation, filters, and event handler Demo
Guest authentication Demo
Guest authentication with multiple modes Demo
Authentication with auth token Demo
Authentication with Identity Token Demo
SAML authentication Demo
SAML authentication 2021 SP2 Demo
Custom error handler Demo
Filter configuration Demo
Using dossier instance ID Demo
Customizing the Library Page with URL API Demo
Single Visualization Demo
Panel Stacks Demo
Selections on Visualization Demo
Selections on Visualization (Initial Load) Demo

Source code

Library Browsing

This example shows how to build a web page to show all the dossiers and documents in your library.



Source code

Single-Dossier React Application

MicroStrategy Dossier can be used as a standalone application. This example shows how to build a React-based single-dossier application using MicroStrategy Embedding SDK.



Source code

More Examples

Other Prerequisites

If you plan to use the samples on a Web page that is on a different domain from your MicroStrategy environment, please also meet the following prerequisites.

Enable Cross-Origin Resource Sharing (CORS)

Cross-Origin Resource Sharing (CORS) provides a way for a web application running in one origin (domain, protocol, and port) to access selected resources from a server in a different origin. A cross-origin HTTP request uses additional HTTP headers to tell the browser to let the web application share resources. For security reasons, browsers restrict cross-origin HTTP requests initiated from within scripts. This means that when a web application requests HTTP resources from a different origin, the response from the other origin must include the right CORS headers.

To enable CORS for the REST Server:

  1. Open the Library Admin page. Your URL should be similar to the following:

  2. Navigate to Library Server -> Security Settings.
  3. Choose the appropriate setting for Allow Library embedding in other sites to reconfigure CORS. picture 1

Using the Library Admin page is the easiest way to enable CORS for the REST Server, but you can also configure CORS manually.

  1. Navigate to MicroStrategyLibrary/WEB-INF/classes/config/
  2. Edit the file in a text editor.
  3. Add the following lines, or replace them if already present:
  4. Restart your MicroStrategy Library web application hosted on the application server.


Google Chrome (version 80+) and Microsoft Edge (version 86+) introduced new changes that may impact embedding.

For Embedding SDK to function as expected in a 3rd party context, it is required to explicitly label session cookies with SameSite=None; Secure.

For more information, see Chrome v80 Cookie Behavior and the Impact on MicroStrategy Deployments.