What is a list?

A list is the browse view for a table — the page end users land on to see all the records, search them, sort them, and click one to open its detail.

Every Builder table can have one or more lists. The default list is shown in the side menu. Additional lists can be linked from a custom button or referenced by other components.

What a list is made of

• Source table — every list reads from exactly one table (joins are not supported in v1).
• Columns — which fields show on each row. You pick from the table's fields.
• Filters — what end users can narrow by (date range, status, search…).
• Sort — the default order; users can also click column headers to re-sort.
• Row actions — what happens when a row is clicked: open the detail page (default), open the edit form, or expose action buttons.
• Pagination — how many rows per page. 25 is a sensible default.

Glossary

• Default list — the list shown in the side menu when this table is selected. One per table.
• Visual query — base WHERE clause built with dropdowns (e.g. status = "submitted" AND days > 3). Most lists only need this.
• Raw query — a hand-written SQL fragment. Use sparingly; harder to maintain.
• Renderer — the visual style of the table itself (Tabler vs DataTables). See DataTables vs Tabler.
• Per-page — rows per page; values between 5 and 200 are sensible.

Where to next

• Step-by-step: configure a list — guided walkthrough
• DataTables vs Tabler — when to use which renderer