Skip to main content

Dockable Filter Control

The Dockable Filter Control panel lets you place an interactive filter panel directly on your dashboard, allowing real-time selection of filter values. You can position and customize the panel anywhere to fit your layout and workflow. Dockable filters work best filtering fields with a small number of values. For larger datasets, the Filtering Panel is a better option.

You can add more than one dockable filtering panel to a single dashboard.

important

For the filtering panel to function, at least one global parameter must be created and linked in the relevant data model.

When to use the dockable filter control

  • Providing on-demand filtering: Interact with filter controls directly for quick data exploration.
  • Customizing filter placement: Position filter controls where they best fit your dashboard layout and user flow.

Add a dockable filter control

  1. In the Toolbar panel, choose Edit Dashboard.
  2. Select Miscellaneous Controls.
  3. Drag the Dockable Filter Control control onto the dashboard. A gray highlight appears to show possible placement sections.
  4. (Optional) To resize the panel, use the sides or corners to make the view bigger or smaller.
  5. Select the settings icon on the panel to open the Properties panel.
  6. In the Data tab, expand the Parameters section and select a parameter from the dropdown list.
  7. Customize the panel further by sorting parameters, adding a title, or adjusting the panel color.
  8. In the Toolbar panel, select Save or Save As to save your changes.

Apply a filter

  1. On a dockable filter control, select a filter.
  2. Click Add to Filter. The selected filters appear at the bottom of the dashboard, and the data refreshes automatically.
    If the Filters bar is hidden, go to the Toolbar panel, select Layout, then click Filters to display it.

Remove a filter

You can remove a filter in several ways.

Using the Exclude from Filter button

  1. On a dockable filter control, select the filter you want to remove.
  2. Click Exclude from Filter. The data refreshes automatically.

Using the Filters section

  1. If the Filters bar is hidden, go to the Toolbar panel, select Layout, then click Filters to display it.
  2. Find the filter you want to remove. Hover over it and click the X icon. The data refreshes automatically.

Using the Clear Filter option

  1. On a dockable filter control, click the Clear Filter icon in the top-right corner. This removes all filters from the dashboard.

Dockable filter control properties

Data

Data Configuration

ParameterDescription
Advanced FilterOpens the Advanced Filter dialog for detailed filter configuration.
ParameterSelects the required global parameter for the filtering panel. This determines which underlying field or values the filter uses.
Prompt NameChooses the prompt used for user input. By default, this matches the global parameter.
Sort OrderSets whether parameter values appear in ascending or descending order.
Sorted FieldChooses the data field used for sorting filter values.
Display ValueSelects which field appears as the label for each value in the panel.

Default Selection

ParameterDescription
Default Selected ValuesSets the value to be automatically selected when the dashboard loads. You can use a global parameter or select a value using the prompt icon.

Design

Title

Visible only when the Properties option is enabled in the panel settings.

ParameterDescription
DescriptionAdds a title or a description to the panel. Select the translation icon next to the text box to add labels in multiple languages.
Description Font SizeSets the font size for the panel description.
ColorSets the font color. Use the color picker and select Apply, or enter a HEX code manually.
PositionPositions the description at the top or bottom of the panel.

Global Panel

ParameterDescription
BackgroundSets the background color of the filtering panel. Use the color picker and select Apply, or enter a HEX code manually.
OrientationSets the layout to vertical or horizontal.
Custom WidthAllows you to manually adjust the panel width when selected.

Items Style

ParameterDescription
ItemsCustomizes the font color, background color, and font size of the filter items. Use the color picker and select Apply, or enter a HEX code manually.
Selected ItemsCustomizes the font color and background color for selected items. Use the color picker and select Apply, or enter a HEX code manually.

Advanced Options

Interactions

Visible only when the Dashboard Filtering option is enabled in the panel settings.

ParameterDescription
Enable the single selectionAllows only one value to be selected at a time.
Views to apply filterSpecifies which dashboard views are affected by the filters.