---
title: "Filter control in Vista | Oplema"
description: "Let readers narrow the visuals on one page, on chosen visuals or on every page that uses a source, with the Filter control on a Vista dashboard."
url: "https://oplema.com/docs/vista/controls/filter"
updated: "2026-11-08"
---

# Filter

Filter lets readers narrow the data behind visuals. It's backed by a Vista Filters block in Strata, placed before the Vista Source.

## Filter a chart by store

A Store control narrows a chart of cups by drink to Oslo, Rome or Lima. Behind it, a Vista Filters block sits between the sales data and the Vista Source. The dashboard is read-only, but the control still works.

Result
| Drink | Store | Cups |
| --- | --- | --- |
| Tea | Oslo | 14 |
| Tea | Rome | 9 |
| Tea | Lima | 6 |
| Latte | Oslo | 21 |
| Latte | Rome | 28 |
| Latte | Lima | 12 |
| Mocha | Oslo | 8 |
| Mocha | Rome | 11 |

1. Select Rome in the Store control. The chart now shows only Rome: Tea 9, Latte 28 and Mocha 11.
2. Select All stores to bring back every store.
3. Look at the flow below the dashboard: Manual Input goes into Vista Filters, then Vista Source.

## When to use

Use Filter to let readers pick a slice of the rows, such as one store or a date range. To feed a chosen value into a calculation without removing any rows, use Parameter.

## Inputs

1 port

**Filter Optional**

Accepts: References.

Accepts one connection on this port.

## Settings

To set one up, add Filter from the Controls tab, then choose a Source and a field in Properties. Applies to sets the reach: This page, Selected visuals or All pages using this source. Available choices sets which values are offered. Show in Strata jumps to the block behind it. See Parameters and filters.

All 40 settings

**Style**

Shows the values as a dropdown, a list or buttons.

Default: `Dropdown`

Options: Dropdown, List, Buttons.

**Orientation**

Arranges the buttons horizontally or vertically.

Default: `Horizontal`

Options: Horizontal, Vertical.

**Show input fields**

Shows or hides editable values beside the slider.

Default: `false`

**Show calendar input fields**

Shows date entry fields alongside the calendar.

Default: `true`

**Calendar placement**

Opens the calendar in a popup, or keeps it visible in the control.

Default: `Popup`

Options: Popup, Always visible.

**Period placement**

Opens the period list in a popup, or keeps it visible in the control.

Default: `Popup`

Options: Popup, Always visible.

**Include All option**

Adds a choice that removes the filter, next to the other options.

Default: `true`

**Show “All” button**

Shows or hides a separate All button that removes the filter.

Default: `false`

**Show all/relevant choices toggle**

Adds a button that switches between relevant choices and all choices.

Default: `true`

**Apply changes**

Applies a multiple selection as soon as it changes, or only when a reader selects Apply.

Default: `Immediately`

Options: Immediately, With Apply button.

**Size (px) (Values)**

Size of the value text, in pixels.

Default: `14`

**Text color (Values)**

Color of the value text.

**Search**

Shows or hides the search box, or lets the control decide automatically.

Default: `Auto`

Options: Auto, Show, Hide.

**Decimal places**

How many digits appear after the decimal point.

Default: `2`

**Prefix**

Text shown before each number.

**Suffix**

Text shown after each number.

**Gap (px)**

Space between buttons, in pixels.

Default: `6`

**Horizontal padding (px)**

Space inside each option on the left and right, in pixels.

Default: `10`

**Vertical padding (px)**

Space inside each option above and below, in pixels.

Default: `6`

**Rounding (px)**

How rounded the option corners are, in pixels.

Default: `6`

**Background**

Fill color of each option.

**Border**

Border color of each option.

**Selected text**

Text color of a selected option.

**Selected background**

Fill color of a selected option.

**Selected border**

Border color of a selected option.

**Step**

Picks the slider increment from the data automatically, or uses the Step size you set.

Default: `Automatic`

Options: Automatic, Custom.

**Bounds**

Takes the slider range from the data automatically, or from the Minimum and Maximum you set.

Default: `Automatic`

Options: Automatic, Custom.

**Track thickness (px)**

Thickness of the slider track, in pixels.

Default: `4`

**Handle size (px)**

Size of the slider handle, in pixels.

Default: `16`

**Track color**

Color of the slider track.

**Active track color**

Color of the selected part of the slider track.

**Allow custom periods**

Lets readers enter their own date range as well as choosing a listed period.

Default: `true`

**Periods**

Relative periods readers can choose from, such as Last 7 days.

Options: Last 7 days, Last 30 days, Month to date, Last month, Year to date, Custom range.

**Text for “All” (optional)**

Leave empty for an automatic label.

**Text**

Label text shown on the filter.

**Show label**

Shows or hides the filter's label.

Default: `true`

**Size (px) (Label)**

Size of the label text, in pixels.

Default: `14`

**Text color**

Color of the label text.

**Corner radius (px)**

Corner radius in whole logical pixels.

Default: `0`

**Border width (px)**

Border width in whole logical pixels.

Default: `0`

## Filter FAQs

**Does a filter restrict what viewers can access?**

No. Viewers can access the input data used by a dashboard. Filters and initial selections do not restrict which rows they can access.

**Do filter selections affect other viewers?**

No. On a published dashboard, viewer selections affect only their own session.

**Can one filter affect several pages?**

Yes. In Applies to, choose All pages using this source.

### Chart your data. Build it in Vista.

Vista opens in your browser, with no account.

[Open Vista](https://oplema.com/editor?path=%2F%3Fopen%3Dvista) [About Vista](https://oplema.com/vista)
