Showing results for 
Search instead for 
Did you mean: 
Community Team Member
Community Team Member
This article details the process of creating a BloX button that applies/removes Break By on one or more widgets. 

Step 1

Create the widget(s) including the Break By field. We will need to retrieve the JAQL for the Break By field and add it later via a custom BloX action. 

Step 2

After creating the widget, open up the developer console and type:
All widgets in the dashboard will be displayed. Identify the target widget by title or subtype. Take note of the index (in this example, the index=7).
Navigate to:
Select the Break By panel (it is the index 2 below). Open it and navigate to:
Copy the JSON of the JAQL. This is what we will be injecting with the BloX custom action. 

Step 3

Create the BloX widget. Here is a simple example with an action set button:
"style": "",
"script": "",
"title": "",
"showCarousel": true,
"body": [
     "type": "Container",
     "items": [
          "type": "ActionSet",
          "actions": [
               "type": "Total/BreakBy",
               "title": "Total/Break By"
"actions": []

Step 4

Create the custom BloX action. In the example, it is called 'Total/BreakBy'. 
Please Note: You will need to change the index in the following line to match the index found in Step 2. If you would like this script to affect multiple widgets, you can add more than one index, separated by commas. 
var widgetIndexArray = [7];
You will also need to replace the JSON in the 'jaql' variable below with the JSON copied in Step 2.
//Variable that stores all widgets that sound be affected
var widgetIndexArray = [7];
//Variable that stores the JAQL to add
var filterJAQL = {
column: "Item",
datatype: "numeric",
dim: "[Exports.Item]",
table: "Exports",
title: "Item"

//Loop through the widgetInsexArray
for(var i = 0;i<widgetIndexArray.length;i++){
     //Get the widget index that corresponds to the index
     var widgetOID = widgetIndexArray[i];
     //Get the widget object
     var widget = prism.activeDashboard.widgets.$$widgets[widgetOID];
     if(typeof widget.metadata.panels[2].items[0] === 'undefined') {
          // does not exist
     else {
          // does exist

//refresh the widget
That's it! The button should now add/remove the Break By for the dashboard widget. 
Version history
Last update:
‎03-02-2023 08:34 AM
Updated by:
Community Toolbox

Recommended quick links to assist you in optimizing your community experience:

Developers Group:

Product Feedback Forum:

Need additional support?:

Submit a Support Request

The Legal Stuff

Have a question about the Sisense Community?

Email [email protected]

Share this page: