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

# CSV import & export

> Bulk import items from a spreadsheet and export your catalog with per-location stock for backups or reporting.

Retrac supports **CSV import** and **export** on paid plans (Pro and above). Use these when onboarding a large catalog or sharing data with accounting and ops tools.

## Export items

1. On **Inventory**, open the **⋯** menu in the toolbar (top right).
2. Choose **Export items**.
3. Select one or more **locations** you can view.
4. Choose columns, date range, and whether to include zero-quantity rows.
5. Download the zip — each selected location is exported as its own CSV file inside the archive (for example `warehouse.csv`, `van-1.csv`).

Name format: `Retrac Inventory Export - {timestamp}.zip`

<Tip>
  Export before major changes or workspace deletion as a simple backup.
</Tip>

## Import items from CSV

1. On **Inventory**, select the **location** you want stock imported into.
2. Open the **⋯** menu → **Import from CSV**.
3. **Select your file** — any standard CSV with a header row.
4. **Map columns** to Retrac fields:

| Retrac field | Required | Notes                                                                 |
| ------------ | -------- | --------------------------------------------------------------------- |
| SKU          | Yes      | Must be unique within the workspace                                   |
| Description  | Yes      |                                                                       |
| Cost         | Yes      | Numeric                                                               |
| Supplier     | No       | Pro feature                                                           |
| Quantity     | No       | Opening on-hand quantity at the **current location**; defaults to `0` |

5. Confirm import and review the summary.

Imports of more than 100 rows are processed in the background. You will receive an email when they complete. Duplicate SKUs in the file or conflicts with existing workspace items are skipped and reported in the summary.

### Import tips

* **Clean SKUs first** — remove duplicates and blank rows in your spreadsheet.
* **Location matters** — quantities always apply to the location selected in the inventory header when you start the import.
* **Plan limits** — imports count toward your **total items** limit. Upgrade if you are importing more than your plan allows.

## Bulk create (without CSV)

For up to 100 items at once without a file, use the [Bulk create items API](/api-reference/endpoint/bulk-create-items). Requires a workspace API key on Business plans and above.
