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

# Tables

> Run an agent over every row of a spreadsheet at once, with your brand's prompts, competitors and pages in each row. Import data, run columns, review results and export.

> [!NOTE]
>
> **Plans:** All plans, [limits](https://docs.usequotable.com/workspace/plans-and-limits.md#how-credits-work) vary · **In the app:** Sidebar → Agent → Tables

A **table** is a spreadsheet where some columns are agents. Put one input per row (a page URL, a keyword, a competitor) and the agent runs once per row, writing its results back into the same row. Hundreds of briefs, audits or outreach emails run at the same time, each reading the prompts, competitors and pages your workspace already tracks.

In the sidebar, open **Agent**, then **Tables**.

## How a table works

```mermaid theme={"system"}
flowchart LR
  I[Input columns<br/>one value per row] --> A[Agent column<br/>runs once per row]
  A --> O[Output columns<br/>written back into the row]
```

* **Input columns** are ordinary columns you type, paste or import into. Each agent input reads one column.
* The **agent column** runs the agent for its row and shows its status.
* **Output columns** (marked ↳) receive the agent's results.

A table can hold several agent columns. When one agent reads another's output, Quotable runs them in that order within each row.

## Create a table

From the Tables home, under **Create a new table**:

| Start from | What you get |
| - | - |
| **Agent** | Pick a published agent. Its inputs and outputs become the columns, and it runs once per row |
| **Template** | A ready-made table with its agent attached, columns set and sample rows filled from your workspace. See [Table templates](https://docs.usequotable.com/actions/table-templates.md) |
| **Data** | A new table from your tracked prompts, competitors, cited pages, a sitemap or a CSV, one row each |
| **Blank** | One Text column and 100 empty rows |

**New table** in the header makes a blank table called "Untitled table".

## Add data

### Import

Click **Import** in the toolbar, or start a table from **Data**.

| Source | Rows | Columns |
| - | - | - |
| **File** | One per line of a CSV or TSV file (`.csv`, `.tsv`, `.txt`; comma, semicolon or tab detected automatically) | One per file column |
| **Tracked prompts** | One per active prompt | Prompt, Topic |
| **Competitors** | One per competitor | Competitor, Domain |
| **Cited pages** | Your pages that AI engines cite, most cited first | Page URL, Citations, Last cited |
| **Sitemap** | Up to 100 pages from a site's XML sitemap, optionally filtered by a search term | URL |

Imports from your workspace are copies: editing the table never changes your prompts or competitors.

**1. Choose the source**

Pick the source and check the live preview (first 20 rows).

**2. Map the columns**

Click **Map columns**. Send each original column to a new column, an existing column, or **Don't import**. Columns with matching names map automatically, and new columns get a guessed type (URL, Number, Date or Text). For files, toggle **Use first row as headers**.

**3. Import**

Click **Import to Tables**. If the table already has content, choose **Add to this table**, **Replace this table** (removes the rows and their agent results; columns stay) or **Import to new table**.

Values that do not fit their column, such as a value missing from a dropdown's options, are left empty and counted in the confirmation.

### Type, paste and fill

Click a cell and type, or press `Enter` or `F2` to edit. Paste from any spreadsheet, and drag the fill handle at the corner of a selection to repeat values down a column. Pasted rows do not create new rows; add rows first from **+ Add row** at the bottom (1, 10, 50, 100 or 1,000 at a time).

## Add an agent column

**1. Pick the agent**

Click **+ Add column → Agent…**. Choose from **All agents** or **Templates**, or click **Create new Agent** to build one. Only published agents run in tables.

**2. Bind the inputs**

For each input, pick an existing column or **+ New column**. An input with exactly one compatible column binds automatically. Required inputs are marked `*`.

**3. Choose the outputs and version**

Tick the outputs that should get a column. Under **Version**, choose **Latest** to follow every publish, or pin a specific version so later edits to the agent do not change this table.

**4. Add to table**

Click **Add to table**.

To change it later, open the agent column's menu and click **Configure**. When you switch versions, **What changes** lists the differences in steps, inputs and outputs.

See [Column types](https://docs.usequotable.com/actions/table-columns.md) for every column you can add and which columns can feed which inputs.

## Run

| To run | Do this |
| - | - |
| **One row** | Click **Run** in the row's agent cell. A dimmed cell says which inputs are missing |
| **A column** | Click **▶ Run** in the agent column's header |
| **Selected rows** | Tick rows (shift-click for a range), then click **Run *agent*** in the toolbar |
| **The whole table** | Click **▶ Run Table**: every agent column, in dependency order within each row |
| **Every table** | On the Tables home, click **Run all Tables** |

Before a column, selection or table runs, a dialog shows how many rows will run and the most credits they can use, and lets you choose:

* **How many rows**: All, 5, 10, 100, or a custom number up to 1,000, taken in table order.
* **Rows without an answer** or **Include rows with existing answers** (re-running uses credits again).

Rows run in the background. You can close the page and they carry on. Rows with a missing input, or already running, are skipped and counted.

### Statuses

| Cell shows | Meaning |
| - | - |
| **Run** | Not run yet |
| **Running** | Queued or in progress |
| **Needs review** | A review step is waiting for a person |
| **Completed** | Finished; outputs written |
| **Failed** | Stopped with an error |

### Stop and retry

* **Stop** in the column header stops the column's queued and running rows.
* **Run failed rows** in the column menu reruns only the failures.
* **Run again** on a cell reruns that row.
* Temporary failures are retried automatically in the background.

## Review results

Click **›** on an agent cell to open the run drawer:

* **Status**, **Elapsed time** and **Credits used**. A failed run says which step it stopped at.
* **Inputs**: the values the run read.
* **Output**: a card per output, with **Copy**, **Download** and **Expand**.
* **Logs**: each step with its duration and status, and the step's inputs and output.

If the agent has a review step, the drawer shows it with **Approve and carry on**, **Reject and stop** or **Put it back**. Edit the content first and the button becomes **Use my version and carry on**. Only the named reviewer or a workspace owner can answer.

**Expand** (or double-click a Long Text or HTML output) opens a rich-text editor. Your edits save automatically and the value is marked as edited. A rerun replaces it.

## Ask Quotable Agent

Click **Quotable Agent** in the table header to open a chat beside the grid. Quotable Agent reads the table (columns, types, options and rows) and can:

* Fill or change cells, up to 200 per change.
* Add a column (text, number, URL, date, boolean, list, long text or dropdown), optionally filled.
* Append rows, up to 200 at a time.

Quotable Agent asks before it changes anything and writes only after you agree. It never writes into agent columns. Try **Describe this table**, **Find missing or inconsistent data** or **Suggest useful columns**. See [Quotable Agent](https://docs.usequotable.com/actions/quotable-agent.md).

## Export

Click **Export** in the toolbar, or **Export** in a table's menu on the Tables home.

| Format | File |
| - | - |
| Microsoft Excel | `.xlsx` |
| OpenDocument | `.ods` |
| PDF | Your browser's print dialog, landscape |
| Web Page | `.html` |
| Comma Separated Values | `.csv` (UTF-8, opens correctly in Excel) |
| Tab Separated Values | `.tsv` |
| JSON | `.json`, an array of objects keyed by column name |

Exports include the visible columns, pinned first, and every row. Agent columns export their status. Lists and objects are written as JSON. Individual outputs can also be downloaded from the run drawer.

## Organize

The Tables home has list and grid views, **Created by** and **Type** filters (folder, table, favorites), sorting by last modified, name or created, and search across names and descriptions. Star a table to pin it to the top. Each table's menu has **Open**, **Rename**, **Duplicate** (copies columns, rows and cells), **Export**, **Move to folder** and **Delete**. Select several tables to move or delete them together.

Inside a table, the view menu sorts rows and sets row height (compact, normal, tall) for your session. Hide, pin and resize columns from the column header; those settings are saved with the table.

## Keyboard shortcuts

| Keys | Action |
| - | - |
| Arrows, `Shift` + arrows | Move, extend the selection |
| `Enter` or `F2` | Edit the cell |
| `Tab` / `Shift` + `Tab` | Move right / left |
| `Delete` or `Backspace` | Clear cells |
| `Space` | Toggle a Boolean cell |
| `⌘/Ctrl` + `A` | Select all |
| `⌘/Ctrl` + `C` / `X` / `V` | Copy, cut, paste |
| `⌘/Ctrl` + `Z`, `⌘/Ctrl` + `Shift` + `Z` | Undo, redo cell edits |
| `Ctrl` + `Alt` + `0` | Hide the focused column |
| `Esc` | Collapse, then clear, the selection |

## Limits and credits

| Limit | Value |
| - | - |
| Rows per table | 1,000 |
| Rows per run | 1–1,000 |
| Import file | 20 MB, 50 columns, 10,000 characters per cell |
| Sitemap import | 100 URLs |
| Cells per paste or fill | 5,000 |
| Dropdown options | 100 |
| Credits per row run | At most 25 |

Each row run uses credits from your workspace's monthly allowance, which depends on your plan. Steps that read your own Quotable data are free; AI and research steps use credits. Credits reset on the 1st of each month. See [How credits work](https://docs.usequotable.com/workspace/plans-and-limits.md#how-credits-work).

Viewers can open and export tables. Editing, importing, running and Quotable Agent need edit access.

## Next steps

> [card] [Column types](https://docs.usequotable.com/actions/table-columns.md)
>
> Every column type and what it holds.

> [card] [Table templates](https://docs.usequotable.com/actions/table-templates.md)
>
> Start from a ready-made table.

> [card] [Quotable Agent](https://docs.usequotable.com/actions/quotable-agent.md)
>
> Ask it to read, fill or edit a table.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.