# Let app users download records as a CSV

> Give people in your live app a CSV of chosen records: with table export, an Export to CSV workflow step, or the Generate CSV pipe.

Source: https://tadabase.com/docs/pipes/generate-csv-pipe  
Status: Verified Nov 17, 2026. Checked against the current product

People using your app can get a CSV file of records without opening the builder. Most apps do this with the table component's export or an **Export to CSV** workflow step. The Generate CSV pipe is an older way that calls your app's REST API and caps how many records go into the file.

## Choose a way

| Way | What people get |
| --- | --- |
| **Enable Export** on a table component | An export button on the table they already see. Pick an export template for the columns. See [Show records in a table](https://tadabase.com/docs/pages/table-component). |
| Export component | An export button on its own, using one of your export templates. See [Let users export records from the live app](https://tadabase.com/docs/pages/export-component). |
| **Export to CSV** workflow step | A CSV built by a workflow, with your filters, sort and columns, saved to a file field on a record so people can download it there. Details below. |
| Generate CSV pipe | A CSV saved to a file field, with a set maximum number of records. Use it only if you already rely on it or need that cap. |

## Build the CSV with a workflow

1. **Create the workflow** Create a workflow on the table that will hold the file, for example a Reports table with a file field. To start it from a button, use the **Manual** trigger. See [Triggering workflows from pages and buttons](https://tadabase.com/docs/workflows/triggering-workflows-from-pages-and-buttons).
2. **Add Export to CSV** Add the **Export to CSV** action and choose the table under **Export from table**.
3. **Choose the records** Under **Filters**, set which records go into the file, for example Status is Lead. Under **Sort order**, set the order of the rows.
4. **Choose the columns** Under **Columns**, click **Auto-fill all fields** to include every field, or **Add** to pick fields one at a time. Each column has a **Field** and a **Column title**. Drag the cards to reorder the columns.
5. **Set the file options (optional)** Open **CSV Options** to set the **File name**, **Delimiter**, **Line ending**, **Include header row** and **UTF-8 BOM**.
6. **Save the file to the record** Under **Output Settings**, choose a file field in **Save file to**. On a field that holds several files, **Append to existing files** keeps the earlier files; otherwise each run replaces the file.

Show the file field on a details page or in a table so people can download the file. Later steps can also use the file, for example to email it.

> **Note:** One Export to CSV step writes at most 500,000 rows. It has no setting for a smaller maximum; narrow the records with **Filters** instead.

## Use the Generate CSV pipe

Apps that already use the Generate CSV pipe can keep it. Its call reads records through the Tadabase REST API, writes them to a CSV and saves the file to a file field on a record you choose.

1. **Create an API key** Open **Settings** > **API Keys**, click **Generate New Key**, turn on **Allow Reads** and **Allow Updates**, and click **Save**. See [Create and manage API keys](https://tadabase.com/docs/developers/getting-api-keys).
2. **Install the pipe** In the builder's left menu, click **Pipes** > **Install Pipe**, search for `Generate CSV`, click it and click **Install**. In the install window, fill every field marked **(required)**, such as the API key and the table and file field that will hold the CSV, and click **Install**.
3. **Check the parameters** Open the installed pipe's **Global Parameters** and **API Calls** tabs to check the API key and see the call's parameters, such as the maximum number of records, the filter, the sort and the columns.
4. **Run it from a workflow** Add **Trigger Pipe**, choose the call under **Pipe Method**, and set the **Parameters**, for example the record ID of the record that should receive the file.

If the pipe is configurable, you can change its request on the **API Calls** tab, for example to add a filter or a column. Add a matching parameter for each one you add. A parameter set to required that you do not fill stops the pipe from running, so set unused ones to not required. See [Adding pipes](https://tadabase.com/docs/pipes/adding-pipes).
