List View

For instructions on how to add a block to your app, see the Blocks page.

Capabilities

Display records from any table as a scrollable list
Show selected fields alongside each record label in the collapsed view
Sort records by a chosen field
Filter which records appear using conditional rules
Restrict editing with a read-only toggle
Enable data download for list fields
Configure the record update form style and behavior
Add a search bar for quick record lookup
Set a custom title and description for the block

Configuration

Select a table Choose the table whose records will be displayed in the list.

Sort by (optional) Select a field to define the default sort order of the records.

List fields (optional) Add fields to display alongside the record label in the collapsed card. Click + Add existing field to select fields. These are the fields visible before a user opens the record.

Powers

Read-only — When enabled, users can view records but cannot edit them from this block.
Allow data download — Enables a download option for the list. Only fields visible in the collapsed view ("card closed") are included; table data beyond those fields is ignored. Some field types may not yet support download.

Filters (optional)

Set conditions to control which records appear in the list. Multiple filters can be combined. Filters are fixed and cannot be adjusted by end users at runtime.

Title and Description (optional)

Title — a label displayed at the top of the block.

Description — additional context shown below the title.

Record Update Form

Defines what happens when a user clicks on a record in the list. For detailed instructions on building and editing forms, see the Forms page.

Form source

Block form — uses a form configured directly in this block. Click Edit block form to customize which fields appear.

Window style Controls how the record form opens:

Traditional (double window) — side-by-side layout with the list and the form.
Triple window — three-panel layout.
Quadruple window — four-panel layout.
Right side window — form slides in from the right.
Full screen — form opens in full screen.
Wider form (double window) — wider version of the double-window layout.

Success behavior Defines what happens after a record is saved. Options include Keep form open.

Style

Background Sets the block background. Default is Transparent.

Display search Toggles a search bar at the top of the list so users can filter records by keyword.

Use Cases and Examples

A support team displays open tickets sorted by priority, showing status and assignee in the collapsed card so agents can scan the list without opening each record.
An operations manager filters the list to show only tasks assigned to their team, then updates progress directly from their phone.
A sales team sets the block to read-only to share a pipeline view with stakeholders who should not edit records.

Keep in Mind

List fields only control what is visible in the collapsed card. The full record form is configured separately under Record Update Form.
Allow data download does not export full table data — it only includes the fields shown in the collapsed card. Some field types may not be supported.
Filters only affect what is displayed in this block. They do not modify the underlying table data or affect other blocks.
The Read-only toggle applies to the entire block. It is not possible to make individual fields read-only from this setting.
The search bar searches within the records already displayed by the block. It does not override the block's filters.

FAQ

1- What is the difference between List fields and the fields in the Record Update form?

List fields are the fields shown in the collapsed card — the preview you see when browsing the list. The Record Update form fields are what appear when you click a record to view or edit its full details. The two are configured independently.

2- Can I have multiple List View blocks on the same page pointing to different tables?

Yes. Each List View block is configured independently, so you can add multiple blocks on the same page, each connected to a different table with its own fields, filters, and sorting.

3- Does the filter set in the List View block affect the original table?

No. Filters in the block only control which records are displayed in that specific block. The underlying table data is not affected.

4- Can I let some users edit records and make the list read-only for others?

No. The Read-only toggle applies to all users viewing that block. To serve different access levels, you would need separate blocks or app-level permission settings.

5- What window style works best on mobile?

Right side window or Full screen tend to work best on smaller screens, as they give the form more space. Traditional double window works well on desktop but can feel cramped on mobile.