Bulk Import

When to use bulk import

Bulk import is designed for catch-up scenarios:

• You have a stack of paper receipts from a business trip.
• You want to digitise a month's worth of receipts in one session.
• You are migrating from another app and have an archive of receipt photos.

For ongoing day-to-day capture, the iOS single-receipt capture flow is faster.

Supported file types

Actual file-count and file-size limits can vary by client and deployment. Follow the validation message shown by your current build if an upload is rejected.

Starting a bulk import

On the desktop Web App

1. Open app.stareceipt.com from a desktop browser and select a ledger from the left sidebar.
2. Open the capture / import surface.
3. Drag and drop your files onto the upload area, or click Choose Files to open the file picker.
4. The Web client groups files into receipt import tasks and can merge multiple photos into one receipt-recognition task when needed.
5. Processing runs in the background.

On mobile (iOS / Android)

1. Tap the + button on the main screen and select Import Photos.
2. Choose multiple photos from your library (long-press to enter multi-select mode).
3. Tap Done — the batch is uploaded and queued for processing through the task-queue flow.

Monitoring the queue

Current shared clients surface import progress through task / queue UIs rather than one universal Import History screen. Use the current client's import or task queue to monitor progress and failures.

Reviewing the results

Bulk-imported entries typically land in the Needs Review flow. This lets you:

1. Quickly scan all extracted fields.
2. Fix any recognition errors in one focused session.
3. Discard any images that were not receipts.

Once you confirm an entry it moves into the ledger immediately.

Tips for a clean import

• Organise files before importing. Give files descriptive names if possible — it makes the review step easier.
• One receipt per image. If a single photo contains two receipts, crop and split it first.
• Consistent orientation. Portrait shots work best; avoid landscape unless the receipt is wider than it is tall.
• Remove duplicates before uploading. If you have the same receipt as both a photo and an email import, duplicate detection will flag it — but it is faster to remove the extra file upfront.
• Use merge intentionally. If you captured one receipt across multiple photos, merge them into a single receipt task instead of importing them as unrelated receipts.