Unleashing the Power of Data Integration with Qlik Mashup: A Practical Step-by-Step Tutorial


In today’s fast-paced business landscape, organizations need to extract actionable insights from their data quickly and efficiently. Qlik Mashup is a game-changing feature that allows developers to seamlessly integrate Qlik’s powerful analytics capabilities into their own applications, providing a unified and customizable data visualization experience. In this blog post, we will dive into the world of Qlik Mashup and provide you with a step-by-step guide, complete with sample code, to help you harness the full potential of this innovative feature.

  1. Setting Up the Environment:

Before diving into Qlik Mashup development, you need to set up your development environment. Here are the key steps to get started:

Step 1: Install Qlik Sense Desktop or Qlik Sense Enterprise on your machine. Qlik Sense Desktop is a free version for personal use, while Qlik Sense Enterprise is a robust, enterprise-grade platform.

Step 2: Familiarize yourself with the basics of Qlik Sense, such as creating apps, building visualizations, and data modeling. Qlik provides extensive documentation and tutorials to help you get up to speed.

Step 3: Install a code editor of your choice. Popular options include Visual Studio Code, Sublime Text, or Notepad++.

  1. Creating a Simple Qlik Mashup:

Let’s create a basic Qlik Mashup that embeds a Qlik visualization into a web page. Follow these steps:

Step 1: Create a new HTML file, e.g., “mashup.html,” in your code editor.

Step 2: Add the necessary HTML structure to your file:

<!DOCTYPE html>
    <title>Qlik Mashup Example</title>
    <!-- Include the Qlik Sense APIs -->
    <script src="https://qlikhost/external/requirejs/require.js"></script>
    <div id="qlik-mashup"></div>

Step 3: In the script section of your HTML file, add the code to initialize the Qlik Sense API and embed a visualization:

    // Configure Qlik Sense
    var config = {
        host: "qlikhost",
        prefix: "/",
        isSecure: true,
        port: 443

    // Load Qlik Sense API
        baseUrl: (config.isSecure ? "https://" : "http://") + config.host + (config.port ? ":" + config.port : "") + config.prefix + "resources"

    require(["js/qlik"], function (qlik) {
        // Initialize Qlik Sense
        qlik.setOnError(function (error) {
            console.log("Qlik Sense Error:", error);

        // Open an app and get a reference to the visualization object
        var app = qlik.openApp("appId", config);
        app.visualization.get("visualizationId").then(function (viz) {
            // Embed the visualization in the "qlik-mashup" div

Make sure to replace “qlikhost” with the hostname of your Qlik Sense server, and “appId” and “visualizationId” with the respective IDs of the app and visualization you want to embed.

Step 4: Save the HTML file and open it in a web browser. You should see the embedded Qlik visualization within your mashup.

  1. Customizing the Mashup:

Qlik Mashup allows you to customize the look and feel of your embedded visualizations. Here are a few examples of how you can enhance your mashup:

  • Modify the CSS styles to match your application’s branding and design.
  • Add interactive filters and selections to enable users to interact with the visualization.
  • Implement custom actions and events based on user interactions.
  • Combine multiple Qlik visualizations into a single mashup.


Qlik Mashup empowers developers to integrate Qlik’s powerful analytics capabilities into their applications, creating seamless and personalized data visualization experiences. By following the steps outlined in this blog post and exploring the available resources, you can unleash the true potential of data integration with Qlik Mashup. Experiment, customize, and innovate to provide your users with valuable insights that drive informed decision-making.