Skip to main content

← /journal / escape / wordpress-to-astro-migration

[post_002] · § Escape

WordPress to a Modern Stack: A 6-Month Migration Playbook

How to leave WordPress without breaking SEO — content audit, redirect map, and what to keep versus rebuild.

DK · Principal Engineering · · 8 min read · Escape

How to leave WordPress without breaking SEO — content audit, redirect map, and what to keep versus rebuild.

[01] §

Why teams actually leave WordPress

It is rarely about the framework. It is about the plugin churn that broke conversion last quarter, the security patch cadence that interrupts sprints, the page-speed score that is costing you ad-spend efficiency, and the hosting bill that keeps creeping. WordPress is fine until your site is load-bearing for revenue, and then the failure modes start to compound.

[02] §

Month 1: content + plugin audit

Start with a crawl: every URL, every meta description, every redirect chain that already exists. Then a plugin inventory: what each plugin does, whether it has a non-WordPress equivalent, and whether anyone would notice if you removed it. About 60% of installed plugins on a typical mid-size site are doing nothing critical. Cut what you can before the migration so you are not porting dead weight.

[03] §

Months 2–4: build the replacement

Astro for the marketing surface, a headless CMS for content the team actually edits (Sanity, Payload, or Markdown if the team prefers files). Forms move to a serverless endpoint or a focused tool like Web3Forms. Search moves to Pagefind or Algolia. Member areas, comments, e-commerce — those are decision points, not defaults; keep WordPress for one of them if it is the right tool.

[04] §

Month 5: redirects + cutover

A redirect map covering every URL that ranks in the top 100 organic queries is non-negotiable. We diff the new sitemap against the old crawl and write 301s for every URL that moved. Run the new site at a staging domain for two weeks; canary 10% of traffic before flipping DNS. Watch GSC and rankings daily for the first month — small recovery dips are normal, prolonged drops mean a redirect was missed.

[05] §

Month 6+: what changes operationally

Marketing edits ship without a developer in the loop. Page speed jumps from a Lighthouse 60s to 95+. The hosting bill drops 80–95%. Security patching becomes a non-event. The trade you make: somebody needs to be fluent in the new stack. That somebody can be us — or you hire for it once.

Working on something like this? Start a project →