Migration
Recovering a failed Google Workspace migration
Failed Google Workspace migration recovery starts by preserving job state and identifying what exists in two estates. Stabilise routing and harmful writes, then compare completion, duplicates and permissions before choosing resume, finish-forward or rollback. Investigation timing depends on source access, tool logs and business impact.
Describe the tool used, source and target, what has already cut over and the business impact. Do not restart jobs or send credentials through this form.
| First step | Preserve job state; assess service impact before pausing harmful operations |
|---|---|
| Triage | Timing agreed after access and impact are understood |
| Commonest fault | Permissions and ownership, not message loss |
| Second commonest | Duplicates from a re-run without state |
| Decision | Finish forward or roll back, stated with reasons |
| Mail continuity | Routing stabilised before any further copying |
Stop the job before anything else
The instinct on discovering a broken migration is to restart it. Resist it. Most migration tools keep state, and a restart without knowing whether that state survived is how a mailbox ends up with two copies of four years of mail, which is a far more expensive problem than an incomplete copy.
Stopping costs nothing that cannot be resumed. Staff are already affected, and one further hour of a known-bad position is cheaper than an unknown one.
Establish what actually copied
Recovery is an accounting exercise before it is a technical one. Both estates are counted: mailboxes and message counts per mailbox, files and folders per drive, ownership and sharing state, group membership, calendar resources, and where mail is currently being delivered.
That count produces the only document that matters, which is a per-object statement of complete, partial, or not started. Everything after this is a decision rather than a guess, and it is the document we hand over whether or not the recovery work continues with us.
- Message counts per mailbox on both sides, not sampled
- File and folder counts per drive, with ownership recorded
- Sharing and permission state, which is what usually broke
- Current MX and routing position, including any split delivery
- Third-party application grants that pointed at the old tenant
Permissions break more often than mail
Mail migration is a mature, well-understood copy. Permission migration is not, because permissions are a graph rather than a list: a file shared with a group whose membership was migrated separately, inside a folder whose owner left, referenced by a link somebody saved in a document.
This is why a migration can report success while staff report that nothing works. The messages arrived; the access model did not. Rebuilding it is methodical work driven by the inventory, and the sequence is ownership first, then group membership, then direct shares, then link-based access.
Finish forward or roll back
Finishing forward is usually right where mail has already been cut over and most content has landed: complete the remaining copy, repair permissions, reconcile, then close. Rolling back is right where the cutover has not happened, or where the target was built on a structure that will cause the same failure again.
Either way the decision is written down with its reasons before work resumes, because the failure being recovered from was frequently a decision nobody had recorded. We would rather hand you an argued recommendation you can reject than resume work you did not choose.
Preserve state and stabilise service before another attempt
Record running job IDs, logs, source access, routing and known destination writes before changing anything. A restart may be safe with a supported resumable job, while a fresh job may duplicate items. Pause harmful writes where justified; do not blindly stop a job that is sustaining service or discard its state.
Recovery acceptance should account for complete, partial and missing objects, not only totals. Compare message IDs or tool identifiers where available, test repaired access, and identify destination-only mail or file edits before considering rollback. Data that survives neither estate nor a retained copy cannot be promised recoverable.
Availability, access and investigation scope determine triage timing. Request a paid assessment with deliverables and decision gates; a universal 48-hour recovery commitment is not established by this page.
| Preserve | Job state, logs, source availability and destination-only writes |
|---|---|
| Stabilise | Approved routing authority and containment of harmful repeats |
| Assess | Object-level exceptions, deduplication and permission tests |
| Decide | Customer approves resume, finish-forward or reconciled rollback |
A decision worth checking
Restarting a new job and resuming a stateful job are different operations. Preserve the original logs and checkpoint information before choosing either; otherwise the recovery team may lose the evidence needed to distinguish incomplete objects from duplicates.
What this doesn't cover
- We cannot recover data that no longer exists in either estate and is past its retention window. Recovery works with what is still there.
- We do not provide expert witness or dispute support against a previous supplier, though the inventory we produce is factual and yours to use.
- We do not resume a third-party tool's job under its own licence unless you hold that licence and authorise it.
- Triage is a paid engagement. We will not quote remediation before the inventory exists, because any such number would be invented.
Discuss a stalled or failed migration
Describe the tool used, source and target, what has already cut over and the business impact. Do not restart jobs or send credentials through this form.
What happens next
We check availability and access requirements before agreeing paid triage. Completion or rollback recommendations depend on the surviving data and job state.
Tenant merge and coexistence considerationsPrefer to talk? Call +44 20 7183 3436 (Mon–Fri 08:00–18:00 GMT).
Questions we get asked
- Our migration failed halfway. What should we do first?
- Preserve logs, job IDs and checkpoints. Identify which job or write is harmful before pausing it; confirm routing and live-service impact with the administrator. Do not start a fresh job blindly.
- How long does it take to know where we stand?
- Timing depends on source and target access, surviving logs, job state and scope. Agree paid assessment availability and deliverables before relying on a triage deadline.
- What usually broke, if the mail arrived?
- Permissions and ownership. Mail copying is mature; the access graph is not, so a migration can report success while staff find that shared drives, group-shared files and saved links no longer work.
- Is it better to finish the migration or roll back?
- Finish forward when mail has already cut over and most content has landed. Roll back when the cutover has not happened, or when the target structure would cause the same failure again.
How this page is verified
Reviewed by Workspace Migration Services migrations desk, Google Workspace migration engineers. Last checked .
- Data transfer and ownership behaviour reflects Google Admin Help documentation as of 2026-09-19.
- Triage sequence and durations are the Workspace Migration Services recovery runbook as of 2026-09-19.
- Practical guidance is not a measured customer outcome claim; no published company dataset is used to establish proportions or failure rankings.
Sources you can check
Related pages
Triage first, decisions second
Describe source and target, tool and job state, current mail routing, missing data and user impact. We will check availability and agree assessment scope before promising recovery work.