What is CSV import?

CSV import lets you add multiple media files or text notes to Speak AI in one go, rather than uploading them one at a time. You provide a spreadsheet (.csv) with a row for each item, map your columns to the fields Speak AI expects, and the app queues everything for processing automatically.

Before you start

CSV import requires an active subscription. If the option does not appear in the New menu, your current plan does not include this feature.

Opening the CSV import dialog

Click the + New button in the app sidebar or topbar.
In the dropdown that opens, scroll to the Automate section and click CSV.

The Import from CSV dialog opens and walks you through three steps: Choose Mode, Map & Preview, and Review & Import.

Step 1, Choose Mode

Select the type of content you are importing:

Media CSV, import media URLs (video or audio files hosted online) to transcribe and analyze. Your CSV must include a column for the item name and a column for the URL.
Text Notes CSV, import plain text content to analyze with AI insights. Your CSV must include a column for the note name and a column for the text.

Each mode card shows the limits that apply: up to 250 records per import and a maximum file size of 500 MB. A Sample CSV download link is available on each card so you can see the expected format before building your own file.

Drop your .csv file onto the dropzone or click it to browse. Speak AI parses the file immediately and advances to the next step.

Note: CSV import works best on a desktop or tablet screen. On mobile you will see a prompt to switch to a larger device.

Step 2, Map & Preview

Speak AI reads your CSV header row and tries to match your column names to the required fields automatically. Review each column and confirm or change the mapping using the dropdowns. Required fields (name, URL or text) must be mapped before you can continue. Optional fields, Description, Created At, Tags, and any custom fields you have set up, can be mapped or skipped.

You can also choose a destination folder and set the source language for transcription on this step.

Step 3, Review & Import

Speak AI shows you a summary of how many rows were detected and flags any invalid rows (rows where a required field is empty). Invalid rows are listed in a table with the problem cells highlighted.

You have two options when invalid rows exist:

Import valid rows only, skips the invalid rows and imports everything else.
Confirm import, submits all rows, including invalid ones (those rows may fail processing on the server).

Click Download error report to save a copy of your invalid rows as import-errors.csv. The file adds an _error column that describes which required field is missing for each row, so you can correct the data and re-import.

Once the import is submitted, Speak AI queues your files for processing. If you selected a folder, a Go to Folder button takes you there directly.

Row cap

Most plans import up to 250 rows per CSV. If your file has more than 250 rows, only the first 250 are imported. Contact us if you need to import larger batches.