Initializing help system before first use

# Configuring Pagination and Filtering

You can further customize how tables are displayed by using special attributes.

Note: All of the available table attributes are documented in the VDL Reference.
Pagination can be invoked by:

- selecting the table in the View Designer and editing the Pagination attribute.
- setting the attribute `page-mode="paged"` within a `<vdl-table>` or `<vdl-datagrid>` element.

By default, this shows 50 items per page but you can change this using an associated `page-size` attribute.
You can add a filter to a table by:

- selecting the table in the View Designer and editing the Search attribute.
- setting `show-filter="true"` within a `<vdl-table>` or `<vdl-datagrid>` element.

A filter provides an end user with an input field at the top of the table which allows them to filter all cells by that value.

A related attribute adds a filter input at the top of each column, allowing your users to filter rows based on matches in each column.

You can add a column filter to a table by:

- selecting the table in the View Designer and editing the Column filters attribute.
- setting `column-filter="true"` within a `<vdl-table>` or `<vdl-datagrid>` element.

The previous example illustrates how to use pagination and filtering.

When adding the `show-filter` and `column-filter` attributes to a table, bear in mind that by default, cells are sorted and filtered by their underling values rather than their displayed values. These differ if a set has a `labels` array associated with it or if a custom cell renderer has been applied to a column. You can change this filtering mechanism to apply to cells' formatted characteristics instead of their underlying values in the code editor by adding the attribute `filter-by-formatted="true"` to a table or column.

Parent Topic Using VDL tables

© 2001-2026 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.