Most import issues are easier to fix before the import runs. Use the preview step first, then use import history for anything that still fails after processing.
The preview shows whether each row is valid before it is imported.
Use the summary chips to filter rows:
valid rows are ready to import.
invalid rows have validation errors.
edited rows have changes you made in preview.
matched existing rows matched an existing record.
skipped rows will not be imported.
To fix a row:
Filter to invalid rows.
Expand the row to see row errors and field errors.
Double-click a cell to edit the value.
Wait for the preview to refresh.
Confirm the row moves to valid.
If several rows need cleanup, choose Download issues. The file includes row numbers, error messages, and mapped columns so you can correct the source spreadsheet.
Use this when:
You need another teammate to fix the source data.
The file has many repeated formatting problems.
You want a record of rows that were intentionally skipped.
You can skip a row from the expanded row details. Skipped rows are not imported.
Use skip when:
The row is a duplicate.
The row should not be moved into CoolFocus.
You want to import the valid rows now and handle a few problem rows later.
Create imports can run with invalid rows if at least one row is valid. CoolFocus will ask you to confirm that invalid rows will be skipped. Download the issues before continuing.
Update imports are stricter. They require matched rows and typed confirmation before the update runs.
Open Import History from the import screen or the record list. Each import shows status, totals, success count, failed count, started time, completed time, and who ran it.
From an import, you can:
Open View Details.
Download the original file.
Download the error report.
Re-run failed rows.
Rename the import for clarity.
Delete the import history record when it is no longer needed.
Very large imports run in chunks. If a chunk reaches its processing time window, the importer safely pauses and then resumes automatically. You may see the status move from Processing to Queued between chunks. No action is required. Progress and counts continue from where the import left off.
Failed rows are not retried automatically when an import resumes. Fix the cause, then use Re-run Failed Rows to process those rows again.
The details page includes tabs for:
Summary: status, progress, entity type, imported by, timestamps, and row status breakdown.
Field Mappings: source columns, destination fields, data types, cleansing rules, and required fields.
Imported: successfully imported rows.
Skipped: rows skipped during preview or processing.
Errors: failed rows.
This page is the best place to confirm what happened after an import completes.
If an import has failed rows, choose Re-run Failed Rows from import history or Re-run Failed from the details page.
Use this after you have fixed the reason those rows failed. The re-run resets failed rows to pending and processes them again.
Note: Failed rows are not retried automatically when an import resumes after a timeout. Use Re-run Failed Rows after correcting the issue that caused the failures.
Tip: Download the error report before re-running failed rows. It gives you a before-and-after record of what changed.
Import your data
Prepare your import file
Importer best practices
