# Automatically import orders via CSV using File Monitor
URL: https://support.starshipit.com/articles/4403712212111-automatically-import-orders-via-csv-using-file-monitor
Canonical: https://support.starshipit.com/articles/4403712212111-automatically-import-orders-via-csv-using-file-monitor
Markdown: https://support.starshipit.com/articles/4403712212111-automatically-import-orders-via-csv-using-file-monitor.md
Updated: 2026-05-07

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Learn how to use the File Monitor to automatically import orders from CSV files.

When using Starshipit in your browser, you can [bulk upload orders directly into your account](/articles/integrations/csv/csv-file-integration). The File Monitor takes this further by watching a folder on your computer and automatically importing CSV files into Starshipit as orders. To find the supported file template, go to [CSV File Setup in Starshipit](https://app.starshipit.com/Members/Settings/Integration/CSVSetup.aspx).

## Set up the File Monitor

1. Open the **Starshipit Desktop App** on your computer.
2. In the menu bar, click **CSV File Monitor** > **Settings**.
3. Tick **Enable CSV File Monitor**.
4. Beside **Directory to watch**, click **Browse** to instruct the File Monitor where to find CSV files to upload from.
5. Beside **Directory where successful files are moved**, click **Browse** to instruct the File Monitor where to move files to once they have been successfully uploaded.
6. Beside **Directory where files with errors are moved**, click **Browse** to tell the File Monitor where to move files to if they have returned errors during upload.
7. Tick **Enable Writeback of Tracking Numbers**.  
   This will retrieve tracking numbers for printed unmanifested orders and place in the specified folder every 5 minutes.
8. Beside **Directory to writeback tracking numbers**, click **Browse** to tell the File Monitor where to move files for tracking numbers.
9. Click **Save** then **Close**.

<!-- callout:info -->
Once the auto-import setting is enabled, the Print App will monitor the folder you specified to read CSV files in real time. The app will then push it to Starshipit over the API using HTTPS.
<!-- /callout -->

## Upload orders with File Monitor

Once set up, you can begin uploading orders into the print app. To upload orders:

1. Ensure that the app is running on your computer.
2. Open the folder you selected as the folder to read CSV files from.
3. Copy paste in (or drag and drop) the CSV file which contains the information for the orders you'd like to upload, into the folder you've selected as the **f****older to read CSV files from**.
4. Once added, StarshipIt will automatically begin uploading the orders.
5. Imported orders will appear in the **New** tab of the Print App and also be available in the **New** tab of the Starshipit web app.

If all orders are imported successfully, the CSV file will be moved to the folder you selected during setup in Step 4. It will also have **_IMPORTED** added to the end of the file name.

If any orders cannot be successfully imported, the CSV file will be moved to the folder you selected during setup in Step 5. It will also have **_ERROR** added to the end of the file name.

## Troubleshooting

File Monitor creates a log of all order imports which can be found by going to **Tools** > **Open Log Folder**.

To see why an order failed to upload, go to **Tools** > click **Open Log Folder** > click to open the **importLog** file.