Resources · 100

URL migration: prepare mappings and test redirects

Change domain or URL structure while preserving useful destinations for old pages and their language editions.

· 3 min

Laptop displaying code on a desk Illustration · fictional scene

What this guide helps achieve

  • Inventory entry points
  • Choose relevant destinations
  • Test responses and signals
  • Check journeys after switching
  • Preserve traceability

Quick check

  • Can every page redirect to the homepage?
  • Can internal links remain old?
  • Must every language be checked?

Step-by-step method

  1. 01

    Inventory entry points

    Combine sitemap, navigation, published pages and important older links. Include useful images, downloads and campaign links. Classify pages as retained, merged or removed; do not assume the sitemap contains every entry point.

    Deliverable: inventory with a decision per URL.

  2. 02

    Choose relevant destinations

    Map each old page to content serving the same need. Handle languages separately. For a merger, check that the destination actually covers the subject. Removal without an equivalent needs an explicit response rather than an arbitrary redirect.

    Deliverable: source, target, language and rationale.

  3. 03

    Test responses and signals

    Check permanent redirects, final destination, status, canonical and hreflang. Look for loops and intermediate steps. Update internal links and sitemap to point directly to new addresses; inspect controllable external citations too.

    Deliverable: results by route family.

  4. 04

    Check journeys after switching

    Test search, forms, downloads and mobile variants. Inspect errors and unexpected destinations on old URLs. Compare page families separately so an aggregate total does not hide an omitted language.

    Deliverable: error monitoring and assigned actions.

  5. 05

    Preserve traceability

    Keep the mapping and correction history. Retain redirects according to search-engine guidance and observed use without promising a universal stabilisation time. Document old-domain management and renewal responsibilities.

    Deliverable: maintained migration register.

Choose the response for an old URL

Each branch represents a testable editorial decision.

  1. Equivalent exists

    Redirect directly to the right page in the right language.

  2. Subjects merged

    Check that the target retains the expected information.

  3. No equivalent

    Document removal and correct internal links to that page.

Illustrative case: a retained technical page should reach its new equivalent; removed content without a successor should not be sent arbitrarily to the homepage.

Reusable worksheet

Complete with your authorised observations. These fields are a working template, not observed results.

FieldInformation to record
SourceOld URL and language
DecisionRetention, merger or justified removal
VerificationFinal target, status, canonical and alternatives

Distinguish the mechanisms

MechanismPurposeCheck or limitation
Retained pageDirect equivalent destinationCheck content and language
MergerPage actually covering the combined subjectsAvoid an overly general target
RemovalConsistent status without an artificial equivalentRemove outdated internal links

Management indicators

IndicatorWhat it measuresFirst action
MappingsURLs with a decision and tested destinationHandle missed entry points
ChainsURLs with unnecessary steps or loopsCorrect to the final destination

Common pitfalls

  • Check content and language
  • Avoid an overly general target
  • Remove outdated internal links

Frequently asked questions

Can every page redirect to the homepage?

That is not a relevant editorial mapping. Choose a destination meeting the need, or document removal where no equivalent exists.

Can internal links remain old?

Update them to the final destination. Redirects help older links but do not replace coherent internal linking.

Must every language be checked?

Yes. A French target does not automatically replace a Japanese page; preserve actual equivalents and available alternatives.

Official references

References consulted: . The method and worksheet propose checks to adapt to your context; they do not constitute certification.