SEO Migration Planner & Validator · one finding
Legacy URL has no safe migration match
Recommended action: Map the legacy URL to the closest intent-equivalent live destination, or deliberately return 410 when none exists.
Fix principle: A migration map is an explicit, reviewable contract between the complete old inventory and the intended new inventory. Prefer the closest equivalent destination, retain unmatched and ambiguous rows for human decisions, and remove loops, chains, collisions, and content mismatches before generating deployment rules.
Implementation for your setup
Confirm first: An old URL is unmatched, weakly matched, ambiguously matched, or collapsed with unrelated URLs onto one destination. The proposed map creates a loop, redirect chain, destination collision, or a destination whose content intent does not match the old page. A URL removed from the old sitemap has no reviewed redirect or deliberate 404/410 decision.
Do not apply when: Every material old URL has one reviewed equivalent destination or an explicit retirement decision, with provenance for how the row entered the inventory. The flattened map contains no loops, chains, ambiguous matches, accidental many-to-one collapses, or destinations outside the approved migration scope.
Likely control points: server · edge-cdn · cms-app · managed-vendor
Choose the layer that owns the final response.
Generic HTTP / HTML
Steps
- Assemble the old inventory from sitemaps, crawls, analytics, logs, backlinks, and archives; retain each URL's provenance and business importance.
- Assemble the complete intended destination inventory, normalize only equivalences that are actually safe for this site, and score candidate matches by path, content intent, and known relationships.
- Require human review for unmatched, weak, ambiguous, many-to-one, or materially content-mismatched rows; do not silently redirect them to the homepage or a broad category.
- Flatten approved targets to their final destination, then reject loops, chains, duplicate source rules, conflicting patterns, and destinations outside the approved new scope.
- Generate deployment rules only from approved rows and preserve the reviewed map as the immutable verification input.
Verify on this platform
- Run structural validation over the complete map and confirm zero loops, chains, duplicate sources, conflicting rules, or unreviewed deployable rows.
- After deployment, request every approved old URL and require one permanent redirect directly to its reviewed destination, followed by a successful final response.
- Compare the deployed result with the frozen reviewed map rather than accepting any successful destination.
Rollback
- Retain the prior redirect configuration and the exact deployment revision.
- If the new rules create loops, widespread wrong destinations, or availability failures, restore the prior configuration as one atomic change and re-run the verification inventory.
Caveats
- A similarity score is evidence for review, not permission to publish a redirect.
- Many-to-one redirects can be correct for genuine consolidation, but they require an explicit decision because they can also hide lost content.
- Deleted content with no equivalent may correctly return 404 or 410; a redirect is not mandatory merely because a URL existed.
Official sources
- Google: site moves with URL changes verified
- Google: redirects and Google Search verified
Platform-managed / ask the vendor
Implementation is controlled by the platform or vendor.
Verify on this platform
- Ask the vendor for its maximum rule count, ordering and wildcard semantics, duplicate handling, export/rollback path, and whether it rewrites chains automatically.
- Verify the final public responses independently against the reviewed source-to-destination map.
Caveats
- Do not treat an accepted import as proof that every rule is active or ordered as intended.
- Escalate if the platform cannot export the active rules or restore the prior configuration atomically.
Official sources
- Google: site moves with URL changes verified
- Google: redirects and Google Search verified
How to verify
- Freeze the reviewed old inventory, destination inventory, mapping decisions, and generated deployment revision.
- Validate zero loops, chains, duplicate sources, conflicting patterns, or unreviewed deployable rows.
- After cutover, verify every approved old URL against its expected destination and preserve failures as evidence.
- Monitor old and new URL traffic, crawl activity, indexing, and server errors through the migration window.
Escalate when
Escalate when the old inventory is materially incomplete, destination intent cannot be established, many-to-one decisions affect valuable pages, or the deployment layer cannot provide an exportable rollback.