Trusted by 10,000+ marketers

  • Private planning
  • Instant access
  • Publication insights

Find your next useful tool

Popular tools and guides

Technical SEO

A WordPress-to-Next.js content migration worksheet

Separate migration decisions into content equivalence, URL mapping, metadata, media and release behavior. A new interface is not a complete migration if valuable old pages and destinations remain unaccounted for. Review the old inventory before switching hosts or enabling redirects.

Illustration of technical tools, gears and chart bars

The short answer

Separate migration decisions into content equivalence, URL mapping, metadata, media and release behavior. A new interface is not a complete migration if valuable old pages and destinations remain unaccounted for. Review the old inventory before switching hosts or enabling redirects.

A worked example

A fictional WordPress archive contains a how-to article, an outdated promotion and a tool page. The how-to may need an equivalent new article; the promotion needs an editorial retirement decision; the tool needs functional testing. Redirecting all three to a general blog index would conceal these different requirements and disappoint returning readers.

A practical checklist

  1. Inventory old URLs with their purpose, traffic evidence when available and editorial status. Assign a proposed action and responsible reviewer to each important route.
  2. Check equivalence between old and new content. Preserve useful assets, attribution and relevant metadata while fixing unsupported or outdated claims.
  3. Test response behavior and the approved mapping before cutover. Keep rollback, indexing controls and post-launch monitoring in the release plan rather than treating them as design tasks.

What to avoid

Avoid claiming the old archive has been migrated when new original articles were merely added. This journal expansion is new content; it does not recreate the full legacy archive or automatically activate redirects. Owner approval is still required for the actual production migration.

A useful follow-up

Do 60 new posts replace a legacy migration audit?

No. New content and legacy URL preservation are separate workstreams, and each needs its own evidence and release decision.

Sources and further reading

Sources support the referenced facts, not a business endorsement or promised outcome.

Editorial note. Review the stated author, sources and publication scope before applying this guidance. Examples are illustrative, not customer results. No ranking, citation or commercial outcome is guaranteed.

Continue with context

Related reading

A canonical URL checklist for a rebuilt website

Choose the intended public URL for each article and make its canonical metadata consistent with that destination. A canonical identifies the preferred equivalent version; it is not a shortcut for merging unrelated pages. Review URL choices before migration rather than relying on whatever route happens to render first.

Read the guide ↗

Internal links that make an article library easier to use

Link to the next explanation a reader is likely to need, using text that describes the destination. A related-reading list should connect different useful tasks rather than repeat the same question on several pages. Build navigation from the reader's decision path, not an arbitrary link quota.

Read the guide ↗

Noindex and robots.txt are different controls

Use the correct control for the actual goal: managing crawler access is different from excluding a page from search indexing. Google's documentation distinguishes robots.txt from a noindex directive. A development preview should have an explicit indexing policy, not an accidental combination of unrelated rules.

Read the guide ↗