> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubspotcards.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Table

> Show rows from associated records or a connected system in a standard table.

# Table

**Table** shows a list of rows from a data source. Use it for things like invoices, inventory lines, or associated deals when you want Card Studio's standard components to control the presentation.

## Availability

Table can be used in all four placements. It is technically allowed in the sidebar, but many columns quickly become too wide.

## Add and configure

1. Add **Table** from **Content**.
2. Enter an optional **Title**.
3. Choose the **Data source (list)**.
4. Choose the number of **Rows shown**: 3, 4, 5, or 10.
5. Write a **Message when empty**.

The list picker offers rows from associated standard objects and list output from connected systems. When you switch lists, Card Studio automatically picks the first four known fields as columns.

## Automatic column formatting

Columns with `date` in the technical field name get a date format. Fields containing `amount` or `total` get a currency format. A field named `status` is shown as a status chip with default mapping for paid, overdue, and open.

External field labels and formats can be changed under **Connected systems**.

## Data, rules, and steps

The table requires a properly declared data source; form, step, and card info cannot be used as table rows. Choosing an associated list creates the data source automatically.

The whole table can be controlled by steps and a visibility rule. For example, use a "count is greater than 0" rule and show a separate empty state otherwise.

## Limitations and tips

The schema allows up to 25 rows and eight columns, but the current designer only exposes 3/4/5/10 rows and automatic selection of up to four columns. Columns, order, tone mapping, and sorting cannot yet be edited manually in the UI.

Use [Associated records](/components/association-table) if you want HubSpot's native association table. Use Table when the data comes from a connector, or when you want a consistent Card Studio presentation.
