# Show records in a table

> Add a Table component, choose its columns, connected values, links and workflow buttons, and set search, filter tabs, groups, export and pagination.

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

A Table component shows records in rows and columns. Use it for lists of records that people scan, search, filter, sort and open.

## Add a table

1. **Add the component** In the Page Builder, open the page, click **Add Component** in an empty column and choose **Table** under **Data Components**.
2. **Choose the records** Answer **Which records should this table 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 a column for every field and, on a page that does not show a record, offers to build an add form and a details page too. **Customize** opens the settings so you pick the columns.
4. **Save** Click **Update & Save** or **Update & Close**.

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

## Add columns

On the **Columns** tab, click an item in the lists on the left to add it as a column, and drag the columns into order in the preview.

![A table component's Columns tab with the Fields, Actions, Links and Connected Fields lists on the left and a preview of the table](https://tadabase.com/docs-shots/pages-table-columns.webp)

| List | What it adds |
| --- | --- |
| **Fields** | A column for a field of the table. Fields already in the table are marked. |
| **Connected Fields** | A column with a value from a connected record, for example the customer's phone number on a table of jobs. Pick the connected table at the top of the list. |
| **Links** | **Edit Link**, **Delete Link**, **Record Details Page**, and links to a **Connected Page** or **Connected PDF**. Edit and details links create the page they open. See [Links](https://tadabase.com/docs/pages/links). |
| **Actions** | Button columns that do something with the row's record, such as **Trigger Workflow** (see below). |
| **Pipe Fields** | Values returned by a pipe, when the table has one on its **Data Source** tab. |

To add a totals row, click **Add Summary** at the bottom of the preview and choose **Sum**, **Average**, **Minimum**, **Maximum** or **Column Dependent** (each column then uses its own **Summary Calculation**).

## Workflow buttons

Under **Actions**, **Trigger Workflow** adds a button that runs a workflow on the row's record. It is listed when your plan includes workflows, and can be added once the table has at least one active workflow with a Manual or Schedule trigger. In the button's settings, **Run Behind the Scenes** lets people keep working while it runs and **Show Progress Notifications** shows its progress. See [Trigger workflows from pages and buttons](https://tadabase.com/docs/workflows/triggering-workflows-from-pages-and-buttons).

> **Note:** The other items under **Actions** (update a record, insert a record, send an email or text message, trigger a pipe and so on) are the older action links. They still work in existing apps, but workflows replaced them: build new buttons with **Trigger Workflow**.

## Column settings

Click a column in the preview to open its settings:

| Tab | What you can change |
| --- | --- |
| **General** | The **Title** or **Hide Column Title**, **Allow Inline Editing** for that column, and options for the field type, such as how a file shows (**Show As** image, link or text link) or **Show in Popup** for links. |
| **Format** | **Column Width** (auto or custom), **Alignment**, and date, time or number formats. |
| **Display Rule** | Change the cell's text or background color, style or icon, or hide it, when the record matches conditions. See [Display rules](https://tadabase.com/docs/pages/display-rules). |
| **Filter Records** | For connection columns, which connected records the cell shows. |

## Sort, limit and filter the records

The **Data Source** tab shows which records the table uses. Its **Data Table** part sets **Sort By** (add more with **Add New Sort Field**) and **Limit Records** (**All Records** or **Limited Records**). **Filters** narrows the records for everyone; see [Choose which records a component shows](https://tadabase.com/docs/get-started/filtering-data). **Pipes** fetches extra values from a pipe.

## Filter tabs

Filter tabs are buttons above the table that each show a subset of the records, for example **Open** and **Closed** jobs. On the **Filters** tab, turn on **Filter Tabs**, then click **Add New Tab** and give each tab a name and conditions. The gear menu next to **Add New Tab** has **Hide Clear Filter Tab**, which removes the tab that shows every record, and **Show As Dropdown**, which shows the tabs as a drop-down instead of buttons.

## Group rows

On the **Groups** tab, click **Add Group By Item** and choose the **Field** to group by. Each group gets a header row; set its **Title**, **Order** (**Ascending** or **Descending**), **Color**, whether it starts **Collapsed**, and where its **Summary** shows (**Bottom**, **In group header**, **Both** or **None**).

## Search, export, pagination and other options

| Option (Options tab) | What it does |
| --- | --- |
| **Enable Search** | Adds a search box. Choose the searchable fields, or leave **All Searchable Fields**. Up to two connection fields can be searchable. |
| **Enable Filters** | Lets people build their own filters on the fields you allow. |
| **Enable Export** | Lets people download the records. Pick an export template under **Select Template** if the table has any. |
| **Allow New Record Popup Page** | Adds a button that opens a form to add a record in a popup. Set its **Button Label** and **Popup Title**. |
| **Enable Inline Editing** | Lets people edit values in the table's cells. See [Inline editing](https://tadabase.com/docs/pages/inline-editing). |
| **Record Limit Per Page**, **Show Pagination**, **Pagination** | How many rows each page shows and where the page links appear: **Top**, **Bottom**, **Top and Bottom** or **Hide**. |
| **Table Layout** | **Dynamic** column widths, or **Fixed**. |
| **No Records Found Text**, **Record Name** | The text when nothing matches, and the singular and plural name used for the records. |
| **Allow Batch Updates**, **Allow Batch Deletes** | Under **Batch Operations**: let people update or delete many records at once. |

The **Design** tab changes fonts, colors and spacing.

## Tables on PDF pages

You can also add a Table to a PDF page. There it has no **Filters** tab, links or action buttons, and **Limit Records** offers **All Records (Up to 250)**. **Groups** still work; a collapsed group prints its header and totals only. See [PDF pages](https://tadabase.com/docs/pages/pdf-pages).
