Header Filter

  • 2 minutes to read

Column headers can display filter buttons. Clicking a filter button invokes a filter dropdown, which lists unique values within a column, and enables you to apply filter criteria against this column. These buttons are hidden by default. To show filter buttons, set the ASPxGridSettings.ShowHeaderFilterButton property to true. You can control the filter button availability for individual columns using a column’s GridDataColumnSettings.AllowHeaderFilter property.

Note that if a filter is applied to a column, other column header filters display unique values of the sorted rows. To show the full list of values (include values of rows hidden by sorting), hold down SHIFT and click a header filter button.

If the control’s ASPxGridBase.AccessibilityCompliant property is enabled, the Header filter supports keyboard navigation. Use Tab to focus a filter button. When the filter button is focused, press Enter to open a header filter popup window. Use Up and Down arrows to navigate the list of filter items. If the GridDataColumnHeaderFilterSettings.Mode property is set to CheckedList, use Tab for this purpose. To close the header filter popup window and apply filter criteria, use Enter. To close the popup window without saving changes in the filter criteria, use Esc.

Header Filter Modes

A Header filter can operate in the four modes listed below. A specific filter mode can be specified for individual columns using a column’s GridDataColumnHeaderFilterSettings.Mode property.

The following two list modes are available for all grid columns.

  • List. The header filter is displayed as a regular list of filter items. Clicking an item invokes a corresponding action and automatically closes the dropdown.


  • CheckedList. The header filter is displayed as a checked list of filter items. In this mode, an end-user can select multiple items simultaneously. When the dropdown window is closed by clicking the OK button, the grid will display those records that contain checked values.


The following two list modes are available for date columns only.

See Also