# selectValues method

Information noteSTABLE.   
  
This API is reliable and breaking changes are unlikely.

selectValues(dimNo, values, toggleMode)

Selects values in this object. Activates the Selection bar and behaves like a standard Qlik Sense selection, including a selection preview.

Tip noteUse the selectValues method in the Backend API if selections should be sent to the Qlik associative engine right away.

Tip noteRefer to Horizontal list for an example that shows both ways of making selections.

## Version history

Version history

| Version state | Details |
| --- | --- |
| Introduced | 1.0 |

## Parameters

### dimNo

Type: Number

Dimension number (ignored if listbox).

### values

Type: Array

Array of values to select.

### toggleMode

Type: Boolean

If true, values in the field are selected in addition to any previously selected items.

If false, values in the field are selected while previously selected items are deselected.

## Example

```
$element.find('li').on('click', function() {
            if(this.hasAttribute("data-value")) {
                         var value = parseInt(this.getAttribute("data-value"), 10), dim = 0;
                         self.selectValues(dim, [value], true);
            }
});
```

## Learn more

* [selectValues method](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/APIs/Content/Sense_ClientAPIs/BackendAPI/selectvalues-method.htm)
* [Backend API](https://help.qlik.com/en-US/sense-developer/May2026/Subsystems/APIs/Content/Sense_ClientAPIs/backend-api-reference.htm)