Playbooks
A real platform migration that keeps every ranking you already earned
A botched platform migration is one of the fastest ways to lose rankings that took years to earn. This is the specific sequence that protects them.
Last updated Aug 15 · 12 min read
Before touching code: a real redirect map
Plan a migration redirect map before writing a single line of the new site — every existing URL that has earned ranking needs a deliberate 301 redirect to its new equivalent, decided in advance, not discovered by 404 reports after launch.
Metadata: wired correctly from day one
On the new Next.js build, wire up generateMetadata so every page actually gets dynamic, correct SEO tags — a common migration failure is every page silently sharing one static title and description because the App Router-specific metadata API was never wired correctly.
Structured data: reproduce it, not lose it
Regenerate every schema type the old site carried using the Schema Markup Generator — structured data is easy to silently lose in a platform migration if it was hand-maintained on the old site and nobody explicitly ports it across.
Performance: confirm the migration actually helped
Run the Website Speed Test on the new site's key pages before fully cutting over — the entire point of a Next.js migration is usually better performance, and this confirms it actually happened rather than assuming it.
Crawlability: check before and after
Run the AI Visibility Checker on both the old and new site before and after cutover — confirm the new deployment did not accidentally introduce a robots.txt or noindex mistake that blocks crawlers the old site never had.
What a migration checklist can't guarantee
Following this sequence dramatically reduces migration risk. It does not guarantee zero ranking fluctuation — some temporary movement during recrawling is normal. What it prevents is the avoidable, self-inflicted losses: broken redirects, lost schema, silently wrong metadata.
Get this done right
A migration is exactly the kind of high-stakes, one-shot work worth getting professionally reviewed. That's what Scult's software team handles, or book a meeting before you cut over.
Need this built into your business?
The free tools and prompts on this site handle the small, solved problems. If what you need is bigger — custom software, built and maintained for you — that's Scult's day job.
