Skip to main content
Version: 1.28 (Current)

Saved Filters New in 2

Audience: Low-code Engineers, Business Users

Skill Prerequisites: Listings

General Description​

A saved filter is a filtered list with a name. It keeps a listing's filters, search, sorting, page size and display type, so the same subset of records opens again with one click, for example Approved invoices, Contracts signed this year or My drafts.

There are two kinds:

  • Predefined filters, saved by Low-Code Engineers, Administrators and Super Users. Everyone who can see the listing can choose them.
  • Users' own saved filters, saved by any signed-in user when the listing allows it. Only the user who saved one sees it.

Both are chosen from the Saved Filters drop-down, at the right end of the listing's filter row.

A listing with no predefined filters, where users can't save their own, looks exactly as before.

What a Saved Filter Can Select​

A saved filter uses the listing's filtering, so it can select records by anything the listing filters or searches on:

To listUse
Documents of one typeThe filter of the Document Type column, for example Invoice.
Records with a value in an indexed fieldThe filter of that column, for example Department = Finance. Columns marked Filterable on an entity are indexed in the database.
Records created by a userThe filter of the Created By column.
Records within a rangeA range filter, such as dates or amounts.
Records that contain some textThe search box. It searches the columns marked searchable.

Filters on several columns, the search and the sorting combine in one saved filter, for example Document Type = Invoice, Status = Approved, a search for ACME, newest first.

The low-code engineer decides which columns can be filtered and searched. Users pick, for each saved filter, which of those columns to filter on and with what values.

Letting Users Save Their Own Filters​

Low-Code Engineers, Administrators and Super Users can always save predefined filters. For other users to save their own:

  1. Open the listing's settings (the gear) and select the Settings tab.
  2. Check Allow users to save their own filters, after Enable Filters.
  3. Save the listing.

The setting is off by default. Visitors who aren't signed in can't save filters.

Turning the setting off hides users' own saved filters, without deleting them. Turning it back on brings them back.

Saving a Filter​

  1. On the listing page, set the filters, the search and the sorting you want.
  2. Select the Save icon (a floppy disk) inside the Saved Filters drop-down. Its tooltip is Save these filters.
  3. Enter a Name, for example Approved invoices, and select Save.

The new filter becomes the chosen one, and Filter saved. shows.

A filter saved by a Low-Code Engineer, an Administrator or a Super User is a predefined filter. Their dialog says Everyone who can see this listing will see this filter. A filter saved by another user is theirs alone.

The Save icon shows only when there is something new to save: the listing differs from how it opens, or the chosen filter was changed.

Names​

  • A name is required, and has at most 255 characters.
  • Two predefined filters on a listing can't have the same name, and neither can two of one user's filters. Upper or lower case and spaces around the name don't make a name different: Memos and memos are the same name.
  • A user's filter may have the same name as a predefined filter. They show in separate groups.

Choosing a Saved Filter​

The Saved Filters drop-down lists:

  1. All: the listing as it was built, with no saved filter applied.
  2. Predefined Filters: the filters saved for everyone.
  3. My Saved Filters: the user's own filters.

Each group is sorted by name, and a group without filters isn't shown. Choosing a filter applies it, and the drop-down shows its name.

A saved filter is a starting point. You can still change the filters, the search or the sorting. An asterisk after the name, such as Approved invoices *, says the filter was changed.

Updating, Renaming and Deleting​

After changing a chosen filter, the Save icon offers:

  • Update "Approved invoices", which saves the changes into that filter;
  • Save as new, which saves them as a new filter with a new name.

Users can't change predefined filters. When a user changes one, the Save icon goes straight to saving a new filter of their own.

To rename or delete a filter, open the drop-down and select the pencil or the bin next to it. Deleting asks Delete the saved filter "Approved invoices"? If the deleted filter was chosen, the listing goes back to All.

Who Can Do What​

UserPredefined filtersTheir own filters
Low-Code Engineers, Administrators, Super UsersChoose, save, update, rename, delete. Always, whatever the listing's settings.None: every filter they save is predefined.
Other signed-in users who can see the listingChoose and refine.Save, update, rename and delete, when Allow users to save their own filters is on.
Visitors who aren't signed inChoose and refine.None.
Users who can't see the listingNone.None.

The Saved Filters drop-down shows when the listing has at least one predefined filter, or when the user can save filters.

The server checks these rules too: a call to save, change or delete a filter that the user isn't allowed to is refused, even outside the listing page.

What a Saved Filter Keeps​

KeptNot kept
The column filters and ranges.Which columns the listing shows.
The search text.The page the listing was on.
The sorting.
The page size.
The display type, when the listing still offers it.

The listing's own pre-filters and permissions always apply on top, so a saved filter never shows records the user may not see.

If the listing later loses a column or filter that a saved filter uses, that part is ignored and the rest still applies.

When the listing's Sync with URL setting is on, the chosen filter and any changes on top of it are kept in the page address. Reloading the page, going back, or sharing the link opens the same filter with the same changes.

The page address names the filter by its id, not by its name. A link to a filter that the person opening it can't see, such as another user's filter, opens on All, with the rest of the address's filters still applied.

With Sync with URL off, a reload opens the listing on All, as it does for any filter.

Moving with the App​

Predefined filters are part of the listing. They travel with its export and import, and with version control from one environment to another: saving, renaming or deleting a predefined filter marks the listing as changed. Each filter keeps its id, so links to it keep working in the target environment.

Users' own filters are user data. They are never exported or deployed, and a deployment leaves them as they are.

Importing a listing exported before saved filters existed leaves the listing's predefined filters as they are.

Messages​

MessageWhen
Enter a name for the filter.The name is empty.
The name can have at most 255 characters.The name is too long.
A predefined filter named "Approved invoices" already exists.Another predefined filter on the listing has that name.
You already have a saved filter named "My drafts".Another of the user's filters on the listing has that name.
This saved filter no longer exists.Someone deleted the filter, for example in another tab.
You can't save filters on this listing.The user isn't allowed to save filters here.
You can't change this saved filter. / You can't delete this saved filter.The user isn't allowed to change or delete that filter.

Example​

A document archive lists contracts, invoices and memos, with filters on Document Type, Status and Department, and a search box.

  1. A Low-Code Engineer filters Document Type = Invoice and Status = Approved, sorts by date, newest first, and saves the predefined filter Approved invoices.
  2. They turn on Allow users to save their own filters.
  3. An accountant chooses Approved invoices, searches for ACME and saves ACME invoices for themselves.
  4. The next day, the accountant opens the archive and chooses ACME invoices under My Saved Filters. Other users don't see it.
  5. The archive is deployed to production with Approved invoices. The accountant's ACME invoices stays in the environment where it was saved.

Considerations​

  • Filtering as the listing does it. Saved filters use exact values, ranges and the search. Conditions such as "contains" or "not equal", and values that change, such as "the current user" or "the last 30 days", aren't available.
  • No default filter. A listing always opens on All. A saved filter is applied when someone chooses it, or opens a link to it.
  • Users' filters are personal. A user can't share a filter with other users or roles. Filters for others are saved as predefined filters by a Low-Code Engineer.
  • Predefined filters are for everyone who can see the listing. To give some roles different lists, use separate listings or pages.
  • Labels can be translated through the listing's localization, under the savedViews.* keys.

Revised 11/16/2026