Skip to main content

Configuring the properties of widget components

Warning noteDEPRECATED.
Widget support is deprecated and will be removed in a future release. See Deprecation Notice – Qlik Sense Widgets and Custom Components FAQ for more information.

This section describes how to configure the properties of components that have been added to a widget in the properties panel builder.

When you have added a UI component to a widget in the properties panel builder, you can configure its properties. To configure components in a widget, select the widget, and click the edit icon Edit at the bottom of the properties panel builder. Click on the settings icon Settings of the component you want to configure.

The following table describes the components that can be added to a widget and the settings in each that can be configured.

Widget components and properties
Component Properties Comment
  • Dimensions Min (Default: 0)

  • Dimensions Max (Default: 0)

  • Measures Min (Default: 1)

  • Measures Max (Default: 1)

Set the Min values to be greater than zero if you want to allow a dimension/measure to be added to the widget. By default, the data component allows one measure to be added. Adjust the Min and Max values as required.

Sorting - This component is blank until you add at least one dimension or a measure to the data component. When two or more dimensions and/or measures have been added, you can reorder the sorting of data in the widget by dragging dimensions/measures to a different position, just as in the properties panel in standard visualizations.

Label: Settings

This component provides a name for a subsection under Appearance for you to add UI components found under Items in the available components panel. You must add a header before you can add any of the UI components.
Input field, Checkbox, Text area, Dropdown list, Radio buttons, Switch
  • Label: Property1

  • Default value

  • Reference: property1

  • Code: settings.property1

All UI components have the following settings:

  • Label. Change the default label (Property1, Property2, and so on) to something more meaningful to users.
  • Default value field. Free text for Input field and Text area. See descriptions of Checkbox, Dropdown list, Radio buttons, and Switch for their default value settings.
  • Reference and Code. When inserted into the HTML of the widget, the code provides a reference to bind the UI component to the widget. The format is settings.property1.
    The value of Reference that appears in the code is also used to identify the component in the insert tool.
Input field Default value

Can be set to an expression.


Default value: False

Set to True or False.

Text area
  • Rows: (Default: 3)

  • Max length: (Default: 512)


Dropdown list
  • Options:(Default: No options)

  • Label: (Default: Empty)

  • Value: (Default: Empty)

  • Default value (Default: No default value)

To add options for the user to choose from in the dropdown list in the widget, click Add. For each option there is a Label field and a Value field, which cannot be left empty. Click in the fields to edit. You can then select a default option, if required.

Radio buttons
  • Options: Option

  • Label: Option

  • Value: Value

  • Default value: Option

By default, there is one radio button with the default label Option and value label Value.

To add further radio button options for the user to choose from in the widget, click Add. For each added option there is a Label field and a Value field, which cannot be left empty. Click in the fields to edit. You can then select a different default option, if required.

  • Options: True/False

  • Label: Label true/Label false

  • Default value: True (set to the right)

By default, the switch has labels True and False, with value labels Label true and Label False. The default setting can be with the switch to the right or left.