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

# Upload Large Files

> Upload and enrich large CSV files through the Reprompt dashboard.

Upload a CSV of places and enrich them in bulk — no code required. Files must be under **200 MB** and include a header row.

Go to **[Place Enrichment → Upload](https://app.repromptai.com/place-enrichment/upload-csv)** to get started.

## Map Your Columns

After uploading, map your CSV columns to Reprompt fields. The dashboard auto-detects columns where possible.

<Frame>
  <img src="https://mintcdn.com/syncupai/exKr1FFpfRAb_cfJ/images/csv_upload/upload-and-mapping.png?fit=max&auto=format&n=exKr1FFpfRAb_cfJ&q=85&s=285501c4661708d508f467aed1861e65" alt="Upload CSV page showing texas.csv with 1,290,391 rows and Essential Fields mapping" width="3024" height="1596" data-path="images/csv_upload/upload-and-mapping.png" />
</Frame>

### Essential Fields

All five fields below are required for best results. You can technically omit either coordinates or address, but enrichment accuracy drops significantly — always provide both when possible.

| Field          | Description                                                                   |
| -------------- | ----------------------------------------------------------------------------- |
| `id`           | Unique identifier for each place                                              |
| `name`         | Business or place name                                                        |
| `full_address` | Full street address as a single string (or map individual components instead) |
| `latitude`     | Latitude coordinate                                                           |
| `longitude`    | Longitude coordinate                                                          |

### Additional Options

Expand **Additional Options** to map extra columns. The more fields you map, the better your results.

<Frame>
  <img src="https://mintcdn.com/syncupai/exKr1FFpfRAb_cfJ/images/csv_upload/column-mapping.png?fit=max&auto=format&n=exKr1FFpfRAb_cfJ&q=85&s=8fe8c94875dc9603de2b9f505f6d663c" alt="Essential Fields and Additional Options column mapping" width="3024" height="1596" data-path="images/csv_upload/column-mapping.png" />
</Frame>

| Field          | Description           |
| -------------- | --------------------- |
| `phone`        | Phone number          |
| `website`      | Official website URL  |
| `category`     | Place category        |
| `house`        | House/building number |
| `street`       | Street name           |
| `city`         | City                  |
| `postalCode`   | Postal / zip code     |
| `state`        | State or province     |
| `country_code` | ISO country code      |
| `country`      | Country name          |

<Warning>
  Map **every field you have**. Unmapped columns are ignored during enrichment, which reduces match quality.
</Warning>

## Preview and Import

After mapping, review the **Preview**, click **Select All**, and confirm the import. The platform automatically splits large files into batches of \~5,000 rows each.

<Frame>
  <img src="https://mintcdn.com/syncupai/exKr1FFpfRAb_cfJ/images/csv_upload/preview.png?fit=max&auto=format&n=exKr1FFpfRAb_cfJ&q=85&s=52da0198436096848075eeb81e251e0c" alt="Preview showing records selected, ready to import as batches" width="3024" height="1596" data-path="images/csv_upload/preview.png" />
</Frame>

## Run Enrichment

Select batches from the list, click **Enrich N batches of places...**, choose **Enrich Place**, and start processing.

<Frame>
  <img src="https://mintcdn.com/syncupai/exKr1FFpfRAb_cfJ/images/csv_upload/datasets-selected.png?fit=max&auto=format&n=exKr1FFpfRAb_cfJ&q=85&s=acb1fa1510c14cdf111b14cd94244967" alt="Batches list with batches selected showing Enrich button" width="3024" height="1596" data-path="images/csv_upload/datasets-selected.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/syncupai/exKr1FFpfRAb_cfJ/images/csv_upload/enrich-place.png?fit=max&auto=format&n=exKr1FFpfRAb_cfJ&q=85&s=ab97f4057ea43602350abeb572bebf75" alt="Run Enrichments dialog with Enrich Place selected" width="3024" height="1596" data-path="images/csv_upload/enrich-place.png" />
</Frame>

## Files Over 200 MB

Split files exceeding 200 MB before uploading. You can use a tool like [`csv-split`](https://www.npmjs.com/package/csv-split) from npm, then upload each part separately.

## Best Practices

* **Map every column** — unmapped columns are ignored, reducing match quality.
* **Provide both address and coordinates** — this gives the best enrichment accuracy.
* **Use descriptive batch names** — name by geography, date, or purpose (e.g. "texas" or "Q1 2025 Store Locations").
* **Start with a sample** — upload 100–1,000 rows first to verify column mapping.

## Next Steps

* [Batch Processing](/guides/batch-processing) - Monitor batches, paginate results, and reprocess failures via the API
* [Place Job Results](/guides/place-job-results) - Understand the enrichment output schema
* [Troubleshooting 40x Errors](/guides/troubleshooting-40x) - Debug common API and upload errors