Import undo window and reason codes reference
Undo window
Section titled “Undo window”An import can be undone for 48 hours after it finishes with status Completed. After 48 hours the undo option is gone and the import can’t be reversed in MapleGather; no manual reversal is offered. Edit a member to correct wrong values, or archive members who shouldn’t be there — one at a time, or by selecting several in the member list and choosing Archive (see Edit a member record and Archive and restore a member).
While the window is open, Undo is available from the ⋮ menu on the import’s row in the import history. When the window closes, Undo is removed from that menu; the row itself stays in the history.
What undo actually does
Section titled “What undo actually does”- Memberships the import created are removed — except one that something now refers to (a subscription, a membership application, an invoice, a payment, a wallet pass or a household) or that has been renewed, cancelled or moved to another level since the import. Those are kept.
- Members the import created are archived — unless they still hold a membership afterwards (one the undo kept, or one given to them since by another import or an administrator). Archived members are hidden from the member list unless you turn on Include archived.
- Existing members whose status the import changed go back to their earlier status — unless their status has changed again since, or another membership now supports it. The undo doesn’t change any other details of existing members.
- Membership levels, custom fields and tags created during the import are not removed.
The undo dialog states these rules before you confirm, and ends: “You can undo an import for 48 hours after it finishes, and an undo can’t itself be undone.” There is no option to change the rules, and an undo is final.
Undo statuses in the import history
Section titled “Undo statuses in the import history”| Status | Beside it | What it means | What you can do |
|---|---|---|---|
| Undoing | Undoing · Live | The undo is running. The page updates itself every few seconds. | Wait. The row changes to Undone when the undo finishes. |
| Undoing | 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. The page 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. |
| Undo stalled | — | The last undo attempt failed. None of its changes were saved. The progress screen and the retry dialog say why: “Other changes to the same members were being saved at the same time.”, “Some of this import’s records changed in a way the undo can’t reverse.” or “The undo hit an unexpected error.” | Select Retry undo from the row’s ⋮ menu. Retrying runs the whole undo again. The 48-hour window doesn’t apply to a retry. An undo can be retried until it has failed 3 times. |
| 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 permission to view members) 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. | Nothing further. The row stays in your history. |
Reason codes
Section titled “Reason codes”The dialog’s Reason for undoing list is required: if you select Confirm undo (or Retry undo) without choosing a reason, the dialog shows “Select a rollback reason” under the list and doesn’t undo. The reason is recorded with the undo and isn’t shown to members. The same list appears when you retry a stalled undo, and the retry records the reason you choose then.
The list is your organization’s set of undo reasons. A new organization starts with the five below.
| Reason | When to use it |
|---|---|
| Mapping error | The column-to-field mappings were wrong and data ended up in the wrong fields. |
| Data quality issue | The source data had problems (invalid formats, missing values) that affect too many rows to fix individually. |
| Organization decision | Your organization decided not to keep this import — for example, the cutover was postponed. |
| System error | Something went wrong in MapleGather during the import. |
| Other | None of the above apply — for example, the same data was imported twice. |
Two other cases:
- No reasons set up. An organization created before the reason list existed may have none yet. The dialog then shows “No undo reasons are set up for your organization yet, so this undo is recorded with the reason “Other”.” instead of the list, and the undo is recorded with Other.
- The list couldn’t be loaded. The dialog shows “The undo reasons couldn’t be loaded, so this import can’t be undone right now. Refresh the page to try again.” and Confirm undo can’t be selected. Refresh the page and open Undo again.