Import job states reference

This page describes every state an import job can be in and what that state means for you as an admin. You’ll see these states in the Migration import history list and on the import progress screen.

Import job states

State	What it means	What you can do
`uploaded`	Your file was received and read successfully. Column mapping hasn’t been confirmed yet. No member data has been touched.	Confirm or adjust column mappings on the mapping screen.
`mapping_pending`	MapleGather is waiting for you to review and confirm the suggested column-to-field mappings.	Review mappings and select Confirm mappings →.
`previewing`	Mappings are confirmed. MapleGather has computed the preview plan — what will be created, updated, and skipped. Nothing has been written yet.	Review the preview and select Confirm import → when ready.
`committing`	You’ve confirmed the import and it’s running. It writes all of its rows in one step, so the progress screen shows a moving bar and “Importing {N} rows. This page updates every few seconds.” — no count of rows done and no time estimate.	Monitor the progress screen. In the import history the row shows Importing with Importing · Live beside it while the list updates itself. Cancelling isn’t available in this release — let the import finish.
`committing` — shown as Importing with Importing · over 15 minutes	The import has no outcome 15 minutes after it started. It may still be running; if so, it finishes on its own. If it has stopped, none of its rows were saved. The progress screen says “This import hasn’t finished after 15 minutes” and checks again every 15 seconds.	Wait a little longer. If it stays like this, select Retry import on the progress screen (needs `imports:write`) — a retry only restarts the import if it has stopped. An import can be started 3 times; a retry after that stops it and marks it `failed`. See Your large import seems stuck or slow.
`completed` (no failures)	The import finished and every row succeeded.	Review the summary screen and send your members their welcome email.
`completed` (with failures)	The import finished, but some rows had errors. Successfully imported rows are in your system; the failed rows need attention. This is sometimes called a partial success.	Download the error report from the summary screen, fix the rows and import them again.
`failed`	The import stopped before it finished, and nothing was imported — there’s no partial state. Every failed import names its cause: the progress screen shows Import failed with a message saying what went wrong and what to do next.	Follow the message: usually fix the file and upload it again as a new import — a failed import can’t be started again or re-mapped. View import summary on the progress screen opens its summary, headed Import failed. The messages are listed in Commit and monitor an import. The row shows a failed badge in your history.
`cancelled`	You cancelled the import mid-run. Any rows that had already been committed remain in your system — they are not automatically rolled back.	Review the summary for committed counts. A cancelled import can’t be undone — Undo is offered only for a `completed` import.
`undoing`	You’ve started an undo and it’s running: the memberships the import created are being removed, the members it created archived, and changed statuses restored, keeping anything used or changed since the import (see How import undo works). The history shows Undoing with Undoing · Live beside it.	Wait. The history updates itself every few seconds, and the row changes to `undone` when done.
`undoing` — shown as Undoing with Undoing · over 15 minutes	The undo has run for more than 15 minutes without failing. It may still be running; if so, it finishes on its own, and the history checks again every 15 seconds.	Wait a little longer. If it stays like this, select Retry undo from the row’s ⋮ menu — a retry only restarts the undo if it has stopped.
`undoing` — shown as Undo stalled	The last undo attempt failed. None of its changes were saved. The progress screen and the retry dialog say why it failed.	Select Retry undo from the row’s ⋮ menu to run the whole undo again. See Your import undo failed or only partially reversed.
`undoing` — shown as Undo failed	The undo failed 3 times and won’t be retried. None of its changes were saved.	Retry undo is no longer offered. Select View imported members (on the progress screen, or in the row’s ⋮ menu; needs `members:read`) to open Members showing only the members the import created, then archive or edit them (see Your import undo failed or only partially reversed).
`undone`	The undo finished. The import’s created memberships are removed, its created members archived and changed statuses restored — except anything kept because it was used or changed since the import. Other details of existing members, and levels, custom fields and tags created during the import, are not changed.	No further action available. The row stays in your history for traceability.

A note on “partial success”

A completed import with some rows failing is still shown as completed — there is no separate “partial” status. The summary screen is headed Partial import and shows a warning, “{N} rows need attention”, with Download error report.