Filter Widget (Beta)

Last updated: November 9, 2026

The filter widget places interactive filters directly on a dashboard, so viewers can filter the dashboard without opening the filters panel. Dashboard designers configure each filter in the widget editor without writing code, and can place it anywhere in the dashboard layout.

Overview

A filter widget is a filter control bound to a single field (dimension). When a user selects values in the filter, the filter widget creates or updates the matching dashboard filter, and the dashboard updates accordingly.

Like a regular widget, a filter widget can go anywhere in the dashboard layout. Filter widgets work in all Sisense embedded deployments, including Compose SDK.

Filter widgets are especially useful in OEM and embedded analytics, where the filters panel is often hidden or does not match the host application's design.

Filter widgets also:

• Keep their selections when the page refreshes.

• Respect the dashboard's Update on every change setting.

• Follow the dashboard's Look and Feel theme.

• Use the same query as a filter in the filters panel, so they add no extra query load.

Filter Types

Each filter widget uses one of the following filter types:

Filter Type	Field Types	Description
List	All (text, number, date)	A searchable drop-down list of the field's members. Supports single or multiple selection, as configured by the designer.
Condition	All (text, number, date)	Filters by a condition. For text and numeric fields, use a comparison operator, such as equals, greater than, or between. For date fields, use a relative period, such as the last 3 months, or a comparison with a date, such as before 09/17/2026.
Calendar	Date	A calendar for selecting one or more specific dates. Supports single or multiple selection, as configured by the designer.
Range	Date	From and To dates that filter to the days between them. You can leave either end open, and you can select dates in the calendar or type them.
Time Frame	Date	A list of ready-made relative time frames, such as Today, Last 7 days, or This year. Users select one time frame. The designer can choose which time frames the filter offers.
Rank	All (text, number, date)	Keeps only the top or bottom N members of the field, ranked by a field the designer selects, such as Top 10 by Revenue. Viewers can change the direction and the number of results, but not the field the ranking is based on.

Sisense 2026.4.0 added the Calendar and Range types, and date support for the Condition type. Sisense 2026.4.1 added the Time Frame and Rank types.

Filter Widgets and the Filters Panel

The dashboard filter that a filter widget creates also appears in the filters panel, as a read-only tile labeled "Linked to filter widget." The filter stays active, but you can change its values only from the filter widget on the dashboard. Hover over the info icon on the tile to see why you can't edit it.

If a dashboard filter already exists on a field, you cannot use that field for a filter widget. For date fields, you can create a separate filter for each date level.

A filter widget's filter is a regular dashboard filter, so it can take part in AND/OR relationships, which you manage in the Filter Relationship Editor as usual.

Prerequisites

• The Filter Widget (Beta) feature must be enabled in Feature Management. It is enabled by default. See Enabling the Filter Widget, later in this topic.

• To add, edit, or delete filter widgets, you must be the dashboard owner, a co-owner, or a shared user with design permission on the dashboard. See Who Can Change Filter Widgets, later in this topic.

Enabling the Filter Widget

The filter widget is enabled by default. An administrator can turn it on or off on the Feature Management page.

To enable or disable the filter widget:

1. Click Admin in the top menu.

2. In the navigation pane on the left, under App Configuration, click Feature Management.

3. In the Filters section, turn Filter Widget (Beta) on or off.

4. Click Save.

When the feature is off, users cannot add new filter widgets. Existing filter widgets stay on their dashboards, but each one displays an unregistered widget message, and users cannot edit it.

For more information, see Managing Sisense Features.

Adding a Filter Widget to a Dashboard

To add a filter widget:

1. Open the dashboard in edit mode.

2. In the dashboard toolbar, click the Add Filter Widget icon. An empty filter widget with a Set up filter button appears on the dashboard.

   

3. Click Set up filter. The widget editor opens.

4. In the left panel, select the field to filter by. A filter widget filters by one field, and fields that other filters already use are unavailable.

5. On the Design tab, select a Type: List, Condition, Calendar, Range, Time Frame, or Rank. The available types depend on the field's data type. See Filter Types, earlier in this topic.

   If you select Rank, click Select field under Ranked by, and select the field to rank by, such as a measure. Ranked by is required: until it is set, you cannot apply the widget settings, and the editor shows "Select a field to rank by."

6. Turn Multi-select on to let users select more than one value, or off to allow a single value. It is on by default.

7. (Optional) Configure the other settings on the Filters and Design tabs. See Filter Widget Settings, later in this topic.

8. Click Apply. The filter widget appears on the dashboard, and its linked filter appears in the filters panel.

9. Drag the filter widget to where you want it in the layout. See Customizing the Dashboard Layout.

10. Publish the dashboard to share the change with other users.

To edit a filter widget later, click the edit icon on the widget. Changes you make in the widget editor take effect only when you click Apply. Click Cancel to discard them.

Filter Widget Settings

Configure these settings in the widget editor:

Setting	Description
Type	How the filter is presented: List, Condition, Calendar, Range, Time Frame, or Rank.
Ranked by	Applies to the Rank type only. The field that the members are ranked by, such as Total Revenue. Required. Viewers cannot change it. Until it is set, the filter widget is disabled and shows Set filter.
Multi-select	Whether users can select more than one value. Applies to the List and Calendar types. On by default.
Customize time frames	Applies to the Time Frame type only. Off by default, so the filter offers the default set of 11 time frames. Turn it on to choose the time frames the filter offers. See Customizing Time Frames, later in this topic.
Dashboard Filters	Which dashboard filters, including other filter widgets, limit the values that this filter widget offers. By default, no dashboard filters affect it. Turn on the filters that should narrow its values. Note: Limiting a filter widget's values by other filters can slow dashboard rendering after each filter update, because Sisense must run additional queries to find the relevant items for each affected filter on the dashboard.
Dimension Filters	Pre-filter the field used in the filter widget to limit the values users can select. Dimension filters work like background filters for the widget. You add a dimension filter to the field in the left panel.
Filter Style	The appearance of the filter control: size, corner radius, alignment, and the border, text, and background colors.

The filter widget supports the dashboard's Look and Feel theme and the widget design settings. See Setting Widget Style.

Customizing Time Frames

By default, a Time Frame filter offers this common set of 11 time frames: Today, Yesterday, This week, Last week, This month, Last month, Last 6 months, This quarter, Last quarter, This year, and Last year. To offer a different set, customize the time frames for the filter widget.

To customize the time frames:

1. In the widget editor, with the Type set to Time Frame, turn on Customize time frames.

2. Click the selector that appears to open the Customize time frames panel. The time frames are grouped into five levels: Days, Weeks, Months, Quarters, and Years. All levels are collapsed when the panel opens.

3. Click a level to expand it. Only one level is open at a time. A collapsed level lists the time frames selected in it, and +N shows how many more are selected when they do not fit.

4. Select the time frames you want the filter to offer. To select or clear every time frame in the open level, click Select all or Clear. To clear the selection in every level, click Clear all. The panel shows how many time frames are selected.

5. Click Save. To go back to the default set, click Restore defaults. To discard your changes, click Cancel.

Keep the following in mind:

• If you remove the time frame that is currently selected in the filter widget, the filter resets to no selection.

• Turning off Customize time frames returns the filter to the default set, even if you customized it before. If you turn it on again, it starts from the default set, not from the time frames you saved earlier.

The following time frames are available, by level:

Days	Weeks	Months	Quarters	Years
Today	This week	This month	This quarter	This year
Yesterday	Last week	Last month	Last quarter	Last year
Tomorrow	Next week	Next month	Next quarter	Next year
Last 7 days	This & last week	This & last month	This & last quarter	This & last year
Last 30 days	Last 2 weeks	Last 2 months	Last 2 quarters	Last 2 years
Last 90 days	Last 4 weeks	Last 3 months	Last 4 quarters	Last 3 years
Next 7 days	This & next week	Last 6 months	This & next quarter	This & next year
Next 30 days	Next 2 weeks	This & next month	Next 2 quarters	Next 2 years
Next 90 days	Next 4 weeks	Next 2 months	Next 4 quarters	Next 3 years
		Next 3 months
		Next 6 months

Date Levels

For a date and time field, select the date level, such as years or months, in the filter control on the widget itself. The date level control in the editor's left panel is not available for filter widgets. A date level that another filter already uses on the same field is hidden.

Who Can Change Filter Widgets

What a user can do with a filter widget depends on their access to the dashboard:

User	Permissions
Dashboard owners and co-owners	Add, edit, and delete filter widgets. Changes reach all users after the dashboard is republished.
Shared users with design permission	Add, edit, and delete filter widgets. Changes affect only the user's copy of the dashboard.
Shared users with view permission	Change filter selections only.

For more information, see Sharing Dashboards.

Filtering with a Filter Widget

How you select values depends on the filter widget's type.

Using a List Filter

To filter with a list filter:

1. Click the filter widget. A drop-down list of the field's values opens.

2. (Optional) Type in the search box to find a value.

3. Select one value, or several if the widget allows multiple selection.

   • Click Select all to select every value, including values not yet loaded in the list. The filter widget then shows Include all.

   • Click Clear all to clear the selection.

Using a Text or Numeric Condition Filter

To filter with a text or numeric condition filter:

1. Click the filter widget.

2. Select a comparison operator, such as Equals, Greater than, or Between.

3. Enter the value or values to compare against.

   

Using a Calendar Filter

The Calendar type is available for date and time fields. It shows a calendar for selecting specific dates, as an alternative to a list of dates.

To filter with a calendar filter:

1. Click the filter widget. The calendar opens.

2. Select a date in one of these ways:

   • Click a day in the calendar.

   • Type a date in MM/DD/YYYY format.

   • Click Earliest date, Today, or Latest date to jump to the first date in the data, today's date, or the last date in the data.

   You can also select dates outside the range that the data covers.

   

3. If the widget allows multiple selection, select more dates. Consecutive dates appear as a continuous range in the calendar.

4. Click Apply.

When several dates are selected, the filter widget shows the first date and an overflow counter, such as +6. Hover over the counter to see every selected date.

If you type an invalid date, the filter is not applied, and one of these errors appears under the field:

• Follow MM/DD/YYYY format: The entry is not in MM/DD/YYYY format.

• This date doesn't exist: The date is in the right format but does not exist, such as February 29 in a non-leap year.

Using a Date Condition Filter

The Condition type on a date and time field filters by a relative period, such as the last three months, or by comparison with a specific date. A new date condition filter starts as Last 1 Year.

Date condition filters use these operators:

Operator	Filters To
Last	A number of past periods, such as the last 3 days.
This	The current period, such as this month.
Next	A number of future periods, such as the next 2 years.
Before	Dates before a specific date.
On or before	Dates up to and including a specific date.
After	Dates after a specific date.
On or after	Dates from a specific date onward.

To filter by a relative period:

1. Click the filter widget.

2. Select Last, This, or Next.

3. Select the period: Year, Quarter, Month, Week, or Day.

4. For Last or Next, set the number of periods.

5. (Optional) For Last or Next, select Including current to include the current period. The panel shows the date range that the condition resolves to.

   

6. Click Apply. The filter widget shows the condition, such as Last 3 Days. Hover over it to see the resolved date range.

To filter by comparison with a date:

1. Click the filter widget.

2. Select Before, On or before, After, or On or after.

3. Type a date in MM/DD/YYYY format, or select a date in the calendar. To jump to and select a date, click Earliest date, Today, or Latest date. You can select dates outside the range that the data covers.

4. Click Apply.

A date condition filter uses a single condition. If you type an invalid date, the filter is not applied, and the panel shows "Follow MM/DD/YYYY format" or "This date doesn't exist."

Using a Range Filter

The Range type is available for date and time fields. It filters to the days between a start date and an end date.

To filter with a range filter:

1. Click the filter widget. The From and To fields open above a calendar that shows two consecutive months.

2. Set the start date: type it in the From field in MM/DD/YYYY format, or click a day in the calendar. The To field becomes active.

3. Set the end date the same way. To jump to and select a date, click Earliest Date, Today, or Latest Date. You can select days outside the range that the data covers; they appear dimmed.

4. Click Apply.

The filter widget shows the range as From – To.

To change one end of the range, click its field and then select a new date.

When you select dates in the calendar, the earlier date always becomes the From date. If you select a To date that is before the From date, the two dates swap.

You can leave one field empty:

• From only: Dates from the start date onward.

• To only: Dates up to the end date.

• Both empty: No filter is applied.

If you type an invalid date, the field gets a red border, and one of these messages appears under it when the panel closes:

Message	Cause
Follow MM/DD/YYYY format	The entry is not in MM/DD/YYYY format.
This date doesn't exist	The date does not exist, such as February 29 in a non-leap year.
Must be earlier than end date	The typed From date is after the To date.
Must be later than start date	The typed To date is before the From date.

Using a Time Frame Filter

The Time Frame type is available for date and time fields. It offers a short list of ready-made relative time frames, such as Today, Last 7 days, or This month.

To filter with a time frame filter:

1. Click the filter widget. A list of time frames opens, with a preview bar below it that shows the earliest and latest dates.

2. (Optional) Hover over a time frame to see the dates it covers on the preview bar.

3. Click a time frame. The filter is applied right away, and the list closes.

The filter widget shows the name of the selected time frame, such as This month. Hover over it to see the dates it covers. To clear the filter, click the × on the filter widget.

Using a Rank Filter

The Rank type is available for text, numeric, and date and time fields. It keeps only the top or bottom members of the field, ranked by the field that the dashboard designer selected in the Ranked by setting, such as Total Revenue. You can change the direction and the number of results, but not the Ranked by field.

Until you apply a rank, the filter widget does not filter the dashboard and shows the Ranked by field, such as Ranked by Specialty. If the designer has not set the Ranked by field yet, the filter widget is disabled and shows Set filter.

To filter with a rank filter:

1. Click the filter widget. The panel opens with Top selected and the number of results set to 10 for text and numeric fields, or 1 for date fields. The Ranked by field appears read-only.

2. Select Top or Bottom.

3. Enter the number of results, or use the arrows to change it. The number must be a whole number of 1 or more.

4. For a date and time field, select the date level, such as Years.

5. Click Apply.

The filter widget shows the applied rank as a sentence, such as Top 10 by Specialty or Bottom 5 Years by Specialty. Hover over it to see the applied rule.

To discard your changes in the panel, click Cancel. To remove the rank and return the filter to its unfiltered state, click Clear in the panel, or click the clear button on the filter widget.

For Top/Bottom ranking in regular dashboard filters, see Creating and Editing Filters.

Limitations

• A filter widget filters by one field (dimension).

• Primary filters are not supported with filter widgets.

• You cannot edit a filter widget's linked filter from the filters panel. Change its values on the filter widget instead.

• When a user clicks a chart element to create a filter, the new filter is added to the filters panel, not as a filter widget.

• Changing the date level of an existing dashboard filter to the level used in a filter widget might link multiple filters to the same filter widget, or vice versa. This issue will be addressed in a future version.

• In a List filter with an active search, "Select all" selects all available members, not only the search matches.

• In Sisense (outside embedded deployments), you cannot currently hide the filters panel.

• You cannot duplicate a filter widget or copy it to another dashboard by dragging it.

• The Embed Code and Change datasource menu options are not available for filter widgets.

• When Widget Style customization is enabled, the filter widget keeps a fixed height of 68 px, which can clip its content, such as the drop-down list. To work around this, increase the widget's height manually after you enable the customization.

Related Topics

• Filtering Dashboards and Widgets

• Creating and Editing Filters

• Compose SDK Mode