Every failed run shows a plain-language reason in the view. This page lists them and what to do. A structural problem also pauses the mapping; fixing the cause and running a clean sync unpauses it automatically.
| Message | What happened / what to do |
|---|
| "Workbook, worksheet, or table no longer exists — recreate the mapping." | The synced file (or its table) was deleted, moved out of reach, or the table was removed. Recreate the mapping; the app will build a fresh workbook. |
| "Workbook is locked by another process — try again in a minute." | Excel or another app holds an exclusive lock. Close the file or wait; the next run typically succeeds. |
| "Microsoft is throttling requests — try again in a few minutes." | Temporary Microsoft-side rate limiting. Nothing to fix; scheduled runs retry on their own cadence. |
| Message | What happened / what to do |
|---|
| "Worksheet 'X' has no table — select your data in Excel and use Insert → Table, then sync again." | The importer needs a real Excel table. Select your data range → Insert → Table (with headers). |
| "Worksheet 'X' has N tables — the sync needs exactly one." | Delete or move the extra tables (or point the mapping at a worksheet with just one). |
| "The Excel table has no 'X' column — rename the header back or remap." | A mapped column's header was renamed or deleted. Restore the header, or use Remap columns. |
| "The key column 'X' is missing from the Excel table…" | Same as above, for the natural-key column. |
| Report line | Meaning |
|---|
| "Row 12: 'Due' is not a date" (and similar) | The cell failed validation for the monday column's type. Fix the cell; the row imports on the next run. Nothing partial was written for that row. |
| "Row 7: duplicate key (also on row 9) — skipped" | Two rows share a key value. The app never guesses which wins — make keys unique. |
| "Row 5: its monday item changed since the last sync — skipped to protect that edit" | You're on skip & flag: someone edited the item on the board. Re-sync after resolving, or switch the mapping to source wins. |
| "Row 3: its monday item no longer exists — skipped (clear the monday_id cell to recreate it)" | The item was deleted on the board. Clear the row's monday_id to recreate it, or delete the row. |
| "Large import: wrote 300 of 4,200 changed rows this pass — the rest continues automatically." | Not an error — big imports proceed in background passes (monday limits write speed). Watch the run log; no action needed. |