# Choose which records a component shows

> Pick a data component's records: all of a table, those connected to the logged-in user or to the page's record, then narrow them with data source filters.

Source: https://tadabase.com/docs/get-started/filtering-data  
Status: Verified Nov 17, 2026. Checked against the current product

Every data component, such as a table, list or chart, works with one table's records. When you add it, you choose which of those records it shows. You can then narrow the list further with data source filters. Both are applied on the server, before any data reaches the browser.

## Pick the records

When you add a data component, the builder asks **Which records should this table display?** (the wording follows the component). The choices depend on your connections and on the page:

| Option | When you see it | What the component shows |
| --- | --- | --- |
| **Select the data table** | Always | Every record in the table you pick. Add filters to narrow it. |
| **Records connected to the logged in user** | When a table has a connection field to or from the Users table | Only the records connected to the person who is signed in. Each connection field is listed as its own choice. |
| **Records connected to this** (record) | On a page that shows one record, such as a details or edit page | Records connected directly to the page's record, for example the jobs of the customer being viewed. |
| **Records Related to this** (record) | On a page that shows one record | Records one connection further away, for example the invoices of all jobs of the customer being viewed. |

Each choice names the connection field it uses, which helps when two fields connect the same tables.

> **Warning:** The choice is fixed once the component is created. Its **Data Table** tab shows the source and a diagram of the connection, but you cannot switch it. To show different records, add a new component.

![A table component's Data Source tab showing its data table and connection, with the Data Table, Filters and Pipes tabs](https://tadabase.com/docs-shots/get-started-filtering-data-source.webp)

## Narrow the records with filters

1. **Open the component** Hover over the component on the page and click the pencil (**Edit**).
2. **Open the filters** On the **Data Source** tab, select **Filters**.
3. **Add a filter group** Click **Add New Filter Group** (or **Add Filter Group** if one exists), then pick a field, a condition and a value.
4. **Save the component** The component now shows only records that match.

Connection fields offer conditions that depend on who is signed in or which record is open, such as **is logged in user**, **is connected to logged in user** and **is connected with current record**. For every condition and how groups combine, see [Data source filtering](https://tadabase.com/docs/pages/data-source-filtering).

![The Filters part of a table component's Data Source tab, where you add filter groups](https://tadabase.com/docs-shots/get-started-filtering-data-filters.webp)

> **Filters sit on top of row-level security:** If [row-level security](https://tadabase.com/docs/get-started/row-level-security) is on for the table, a user only gets the records it allows; the component's source and filters then narrow that further. A component filter can never show a record that row-level security hides.

## Let users filter and search

The filters above are set by you and always apply. To let people filter for themselves, a table component has **Filter Tabs** on its **Filters** tab (buttons above the table that each apply a filter) and **Enable Search** on its **Options** tab. These only narrow what the component already shows. See [Table component](https://tadabase.com/docs/pages/table-component).

For more on data sources, see [Data source](https://tadabase.com/docs/pages/data-source).
