# 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.

Source: https://tadabase.com/docs/pages/list-component  
Status: Verified Nov 17, 2026. Checked against the current product

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](https://tadabase.com/docs/pages/data-components-overview).
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](https://tadabase.com/docs/pages/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](https://tadabase.com/docs/pages/table-component#workflow-buttons).
- **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](https://tadabase.com/docs/pages/table-component#column-settings).

## 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](https://tadabase.com/docs-shots/pages-list-layouts.webp)

## 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](https://tadabase.com/docs/get-started/filtering-data). 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](https://tadabase.com/docs/pages/table-component#filter-tabs).

## Options

| Option (Options tab) | What it does |
| --- | --- |
| **Enable Search** | Adds a search box above the list. |
| **Show Pagination**, **Pagination** | Shows page links at the **Top**, **Bottom**, **Top and Bottom**, or hides them (**Hide**). |
| **Record Limit** | How many records the list shows. |
| **Hide Empty Fields** | Leaves out fields that have no value for a record. |
| **Add Line Between Records** | Draws a line between records. |
| **No Records Found Text**, **Record Name** | The text when nothing matches, and the singular and plural name used for the records. |
| **Enable Inline Editing** | Lets people edit values in place. See [Inline editing](https://tadabase.com/docs/pages/inline-editing). |
| **Allow Export** | Lets 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](https://tadabase.com/docs/pages/pdf-pages).
