Show records as a list or gallery

Add a List component to show each record as a block of fields, in one column or a grid of up to six, with images, links, filter tabs and search.

  • Verified Nov 17, 2026
  • Classic builder

On this page
  1. Add a list
  2. Add fields
  3. Choose the layout
  4. Records, filters and filter tabs
  5. Options

A List component shows each record as its own block of fields instead of a table row. Use it when records have a picture or longer text, such as a directory, a product gallery or a list of jobs with notes.

Add a list #

  1. Add the component In the Page Builder, open the page, click Add Component in an empty column and choose List under Data Components.
  2. Choose the records Answer Which records should this list display? See Choose which table and records a component shows.
  3. Quick Add or Customize Quick Add adds every field; Customize opens the settings so you pick them.
  4. Save Click Update & Save or Update & Close.

The settings window has these tabs: Data Source, Fields, Filters, Layouts, AI Prompts (when AI prompts are available in your app), Options and Design.

Add fields #

On the Fields tab, click an item on the left to add it to the record's block on the right. Arrange the block in rows and columns: hover over a row to add a column, and drag fields between them. The lists on the left are:

  • Fields: the table's fields.
  • Connected Fields: values from a connected record. Pick the connected table at the top of the list.
  • Links & HTML: Edit Link, Delete Link, Record Details Page, Connected Page, Connected PDF, and HTML for your own text. See Links.
  • Actions: buttons that act on the record, including Trigger Workflow for running a workflow; the other actions are the older action links that workflows replaced. See Table component.
  • Pipe Fields: values from a pipe on the Data Source tab.

Click a field in the block to change its settings: its title, format, and a Display Rule to change its color or icon, or hide it, based on the record. They work the same way as table column settings; see Table component.

Choose the layout #

On the Layouts tab, List Layout sets how many records sit side by side: 1 Column for a list, or 2 Columns, 3 Columns, 4 Columns or 6 Columns for a gallery or grid. Below it, choose the style of each record's block:

  • Default: the fields with no frame.
  • Bordered Box: each record in a box. Set the Border Position, Border Width, Border Color, Border Radius and Box Shadow, choose an Image Cover Field to show a picture at the top of each box, and Add Border Between Fields if you want lines between the fields.
A list component's Layouts tab with the List Layout column count and the Default and Bordered Box styles

Records, filters and filter tabs #

The Data Source tab sets Sort By and Limit Records, and its Filters narrow the records for everyone; see Choose which records a component shows. The Filters tab adds Filter Tabs, buttons above the list that each show a subset of the records, set up the same way as on a table.

Options #

Option (Options tab)What it does
Enable SearchAdds a search box above the list.
Show Pagination, PaginationShows page links at the Top, Bottom, Top and Bottom, or hides them (Hide).
Record LimitHow many records the list shows.
Hide Empty FieldsLeaves out fields that have no value for a record.
Add Line Between RecordsDraws a line between records.
No Records Found Text, Record NameThe text when nothing matches, and the singular and plural name used for the records.
Enable Inline EditingLets people edit values in place. See Inline editing.
Allow ExportLets people download the records.

Lists can also be added to PDF pages. There the Filters tab, links and action buttons are not available, and Limit Records offers All Records (Up to 250). See PDF pages.

Was this page helpful?

Something wrong or missing on this page? Tell us.