Knowledge Base Article

Using text widgets to present script, plugin, and BloX action information

Sisense Text Widgets can be programmatically updated to display messages generated from scripts, plugins, or Blox actions. This provides a non-intrusive and non-disruptive method for showing contextual information directly within the dashboard, avoiding the interruptions of alerts or pop-ups created by custom code, are present in PDF and image exports, and removing the need for viewers to check the browser console. Messages can confirm when custom code has executed or highlight exceptions where a condition was not present requiring a custom code dashboard modification. (Applicable to Sisense version 2023.11 and later | Cloud and On-Prem deployments.)

Step-by-Step Guide: Navigate to the dashboard where you want to display contextual messages. Add a Text Widget to the dashboard and place it in a visible location for status or context informat...
Dashboard message reads “Dashboard filters were updated programmatically” with pivot table showing brand
Published 08-15-2025
JeremyFriedel's avatar
JeremyFriedel
Sisense Employee
08-20-2025

The code appears to not have line breaks when viewed in some browsers, here is the code with line breaks:

if (adjustmentMade && adjustmentMessages.length) {
    const $widget = $('#editor-container > div.wd').first();
    if ($widget.length > 0) {
        $widget.text(adjustmentMessages.join(" "));
    } else {
        console.log(adjustmentMessages.join(" "));
    }
}

 

function showMessage(msg) {
    const $textWidget = $('#editor-container > div.wd').first();
    if ($textWidget.length > 0) {
        $textWidget.text(msg);
    } else {
        console.log(msg);
    }
}

// Example usage: notify when filters are changed
dashboard.on("filterschanged", function () {
    showMessage("Dashboard filters were updated programmatically.");
});

 

// Inside a larger script - update text widget when filter is adjusted
if (adjustmentMade && adjustmentMessages.length) {  
    const $widget = $('#editor-container > div.wd').first();  
    
    if ($widget.length > 0) {  
        $widget.text(adjustmentMessages.join(" "));  
    } else {  
        console.log(adjustmentMessages.join(" "));  
    }  
}

 

About Widget & Dashboard Scripts

Node avatar for Widget & Dashboard Scripts
200 ArticlesCreated: 6 months agoLatest Activity: 04-15-2025