Vizlib Home Try Vizlib

Vizlib KPI Designer - applying Layer settings

Layer settings are used to add and customize data visualizations within the KPI object. They help you control and modify objects individually as you lay them out in the KPI Designer.

KPI Designer’s lightweight versions of popular Vizlib extensions help you create dashboards that load quickly but deliver the depth of information you need to convey.  


Layer properties

You can add, clone, copy and remove the layers you create. 

From the properties panel, click Layers to start. The layer options display at the top of the Layers section heading (Figure 1). 

Create and name your layers.

Figure 1: Create and name your layers

Good practice with Layers

We do not recommend adding more than ten layers to a KPI object, as this can cause issues with performance. You can find more tips on working with KPI Designer in its Best Practice article. 

Adding more than one master item in a KPI layer, you'll find performance could be affected. It's better to have one KPI object and multiple layers within it, though we also don't recommend using more than ten layers per object.


The Qlik Sense hub engine is better at processing layers than objects, which is another reason for having multiple layers in a single object.

Adding a Layer 

  1. From the properties panel, click Layers.
  2. Click Add Layer
  3. Select a Layer type
  4. Enter a descriptive Layer Name that identifies the Layer quickly.  
  5. The number of layers in the object is shown in brackets beside the Layer section header. In Figure 2, the example shows nine layers - Layers (9).

Figure 2: Layer types

Back to Contents

Layer types

Vizlib KPI Designer supports the following layer types to choose from. Each layer type has distinct properties, which you can read about by clicking the layer name and shared settings.

Bar ChartLine ChartBullet ChartGauge Chart
Master ItemPie ChartIcon Bar

Using the Read-only option with a Master Item

Keeping your dashboard light so it can load quickly is KPI Designer’s key strength; however, there may be times when you want to allow more interaction with a specific object on your dashboard. 

The option to Read only with a Master item allows interaction with the Master item(s) you select. This provides a focused area where your user can explore the data more in-depth - but you still keep the benefits of using KPI designer. You can enable the following: 

  • Scrolling within a table 
  • Hover over a line chart to display the tool/Viztips 

  • updates for all the other Master items when you interact with that Master item.

To use the Read-only property: 

  1. Click Add Layer 
  2. Select Master Item
  3. Scroll down to view the Read-only option, and click in the box to select it. 

Please note: you can interact with it on the KPI but cannot (as of yet) do it with a Viztip. 

Back to Contents


For each layer, you can choose a Background Color, set the Background Color Opacity, and set the Padding Width (Figure 2).

Figure 3: Background

Back to Contents


You can enable a Layer Border (Figure 3), and choose the layout with the Border Selector, choose a Border Style, a Layer Border Color, and set the Lay Border Width and Lay Border Radius

Figure 4: Border

Back to Contents


If you Enable Tooltip (Figure 4), you'll be able to enter some Tooltip Text, choose a Font Color, Font Size, Font Style and Font Family

Figure 5: Tooltip

Background Color (Figure 5), control the Opacity with the slider, choose a Tooltip Position, and enable Tooltip Fits Window to stop the text being cut off when it's opened at the edge of the sheet. 

Figure 6: Tooltip

Back to Contents

Vizlib Actions 

Vizlib Actions ( Figure 6 ) allow you to apply an action after clicking on the KPI Object. If you click Add Action, you'll open the action settings. Then choose the action you want from Pick Action. You can find out about how to work with Vizlib Actions here

Figure 7: Vizlib Actions

Back to Contents

Position, Visibility

You can use the Position controls (Figure 7) to set the position (X and Y coordinates), Width, and Height. You can also enter a Visibility condition to show or hide the layer.

Figure 7: Position, Visibility

Back to Contents

Luke is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.