Vizlib Home

Viztips - Overview

Viztips brings the Vizlib KPI Designer into other extensions, as a rich, fully customisable tooltip. Viztips support 10 layers of the KPI Designer, this excludes master item layers. The tooltip shows based on the dimension which is being hovered over.

Getting started & requirements

To use Viztips, your Vizlib KPI Designer must be a master item. Each time you want to return a value related to the item you are hovering over, you can use the following type of expression. This works well for measures, and vl_viztipsSet is replaced by the value you've selected. 


=sum( $(vl_viztipsSet) Sales)

So if you used Country as a value and hovered over USA, the expression here would show the Sales figures for the USA. 

Best for strings/dimension

=maxstring( $(vl_viztipsSet) [Sales Person] )

Step-by-step tutorial

  1. Start by creating a KPI Designer object, choose a template or create your own (in the last step this created the variable, so we have something to work with)

  2. Enable Viztips in the property panel of your chosen chart

  3. Add/write expressions to be used by Viztips (these can be based on the expressions above).
    If you have existing set analysis refer to the section below

  4. Add the KPI Designer object as a master item

  5. Select the KPI Master item

  6. Hover over your chart dimension to see your Viztip

Using Viztips with existing set analysis

If you have your own set analysis and want to work with Viztips, the type of formula below will work. Make sure this occurs in the set, please note that the variable in use is different. If you've already applied a set analysis, you should use the vl_viztipsInlineSet variable in the expression here. 

=Avg({$<[Month]={'Apr'} $(vl_viztipsInlineSet)>}[Amount])

Dynamic labels for Viztip tool-tips

Other Viztips variable include those shown below, with the relevant expression below. If you use more than one dimension, then these will be named consecutively based on the hierarchy they are dispalyed in, simply use variable 02 for the next and 03, 04 then on.

  • vl_viztipsFieldName01 - shows a string for the Field name hovered over
  • vl_viztipsFieldValue01 - shows a string for the value being hovered over

    Known Limitations

    • When editing Vizlib KPI Designer master item objects which are used in Viztips, it is best to refresh after making changes since some configurations may be cached. Some changes may be visible immediately, this depends on how Qlik Sense will refresh objects, which may vary between versions of Qlik Sense.

    • The layer type "Master Item" (used for including other visualisations in the Vizlib KPI Designer), is not supported

    • Viztips applies to all measures shown within a chart - it cannot be configured per measure. Whilst Viztips is enabled, Custom HTML tooltips will be disabled.

    • When cloning apps with Viztips, users may need to expand the Viztips section of the property panel for it to be configured in a new app

Piers 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.