AccountedPro - The filter bar
The Filters panel builds the bar above the list — the controls readers actually touch. It is separate from the conditions a builder writes: those decide what the list is, these decide what a reader can narrow it to.
Filter settings
| Setting | Notes |
|---|---|
| Label | What the control is called |
| Control | One of the seven types below |
| Where | Always visible, or Under More Filters (a collapse) |
| Filters this field | The field it narrows — for a standard data source |
| Sends this argument | The argument name it passes — for a Server Script data source |
| Default | Applied when the list opens |
| Show this only when… | Roles and/or a condition |
The control types
| Type | Behaviour |
|---|---|
| Select | A fixed set of choices, entered as Choices (comma separated). |
| Link | Searches a DocType as you type, server-side and debounced — like any link field. Options can also come from a Server Script data source. |
| Period | A date range with presets: today, this week, this month, this quarter, this year, and the previous of each. The week start is configurable. |
| Number and operator | A number box with =, !=, >, >=, <, <= beside it, so "over 1,000" is one control rather than two. |
| Text | A free-text contains search. |
| Date range | Two dates, from and to. |
| Check | A tickbox — on means the condition applies, off means no filtering. |
How filters compose
Everything narrows the same query, and nothing replaces anything else:
layout's base condition
∩ active tab's condition
∩ filter bar
∩ Frappe's own Filter dialog
A tab is a floor, not a replacement: switching tabs keeps what is in the filter bar. Clearing the bar does not clear the tab.
What readers see
- Active filter chips under the bar, each removable on its own.
- Clear all, which resets to the defaults rather than to nothing.
- More filters, if any filter is placed there.
- The views dropdown, for saved arrangements.
A filter with a default shows its chip immediately, so nobody wonders why the list is not showing everything.
Clicking a value to filter by it
An element whose Clicking it is set to Applies a filter turns every value in that column into a filter — click a status, see only that status, exactly as Frappe's own list behaves. Clicking again removes it.
Frappe's own filter dialog
The Filter button in the toolbar is kept deliberately. It writes into the same place the chips read from, its filters are URL-shareable, and every other view understands them. Anything the bar cannot express, that dialog can.
The row of per-field quick-filter inputs that Frappe puts above the list is hidden by default, because it duplicates this bar and wraps onto a second line on a DocType with more than a few fields. It can be brought back under List settings → Quick filters.