TR Search Mechanics
Field note / Migrations

The Migration Checklist That Starts Before Redirects

Practical checks, evidence boundaries and an operational worksheet for in-house search teams.

This field note is a working method, not a universal scoring model. Use it to organize evidence, expose uncertainty and define the next test.

01. Define what is changing

A migration may alter domain, protocol, paths, rendering, CMS, information architecture or several at once. List each dimension and the owner. Risk rises when teams treat a combined platform and taxonomy rebuild as a simple redirect project.

Document what must remain stable as well as what will change.

Decision question: What observation would prove this explanation wrong, and which URL sample would reveal it fastest?

02. Inventory by pattern and value

Export known URLs from crawls, XML sitemaps, analytics, backlinks, Search Console and application data. Normalize them, preserve source flags and group by template. Individual URL lists without pattern ownership become unreviewable.

Mark high-value, recently active and externally linked cohorts for focused launch monitoring.

Decision question: What observation would prove this explanation wrong, and which URL sample would reveal it fastest?

03. Write mapping rules before rows

Define one-to-one, many-to-one, removed and intentionally unchanged patterns. Then generate mappings and sample every rule. Avoid redirecting unmatched legacy pages to the homepage; it obscures information loss and often behaves like a soft 404.

Every rule needs an acceptance test and named owner.

Decision question: What observation would prove this explanation wrong, and which URL sample would reveal it fastest?

04. Crawl staging as a system

Compare old and new templates for status, indexability, canonical behavior, rendered primary content, internal links, metadata, structured data and pagination. Staging blocks can hide production differences, so record environment-specific limitations.

Use test data that exercises edge states, not only polished examples.

Decision question: What observation would prove this explanation wrong, and which URL sample would reveal it fastest?

05. Control launch day

Freeze avoidable content changes, capture final old-state evidence, deploy monitoring and test representative URLs immediately. Check redirect hops, robots, noindex, canonicals, sitemap availability, navigation and critical rendering.

A concise launch room checklist is more useful than a large audit document nobody can execute under time pressure.

Decision question: What observation would prove this explanation wrong, and which URL sample would reveal it fastest?

06. Monitor cohorts over 90 days

Track old and new URL requests, index coverage, landing-page visibility and conversion by mapped cohort. Investigate rule-level anomalies rather than reacting to a single site-wide percentage.

Keep the redirect map and decision log available after launch; migrations produce delayed edge cases.

Decision question: What observation would prove this explanation wrong, and which URL sample would reveal it fastest?

Operational worksheet

Use one row per URL pattern or content cohort. Record the symptom, expected behavior, evidence source, conflicting observations, suspected mechanism, population size, owner and next validation date. Preserve examples that do not fit the leading theory; they often reveal a second template or release path.

  • Define what is changing: record evidence, owner and acceptance test.
  • Inventory by pattern and value: record evidence, owner and acceptance test.
  • Write mapping rules before rows: record evidence, owner and acceptance test.
  • Crawl staging as a system: record evidence, owner and acceptance test.
  • Control launch day: record evidence, owner and acceptance test.
  • Monitor cohorts over 90 days: record evidence, owner and acceptance test.

Choose controls before changing the site

Select unaffected URLs that share the same template, age range and demand profile as the affected cohort. Controls make it possible to distinguish a technical recovery from seasonality, a broad ranking update or a reporting change. Record their status before release and inspect them on the same schedule as changed URLs. If controls move in the same direction, reconsider the proposed mechanism before claiming success.

Keep evidence at URL and pattern level

Site-wide totals are useful for orientation but poor for implementation. Attach every finding to an example URL, the rule or template that produced it, and an estimate of the affected population. Store the exact observation date because crawling and indexing evidence changes. When platform reports disagree, preserve both observations and add the next test; do not average contradictory states into a misleading score.

Turn findings into acceptance criteria

An engineering ticket should describe expected user and crawler behavior. Name the response status, rendered content, indexability directive, canonical target, internal-link source and sitemap state where relevant. Include examples that must change and controls that must remain unchanged. “Fix canonical tags” is not testable; “pagination URLs declare self-canonicals while filtered duplicates consolidate to the clean category URL” is.

Sequence validation by processing delay

Some checks are immediate: deployed markup, response headers, links and redirect behavior. Crawl discovery takes longer. Index selection and traffic response can take longer still. Separate these checkpoints so a team does not roll back a correct release because a search platform has not reprocessed the cohort. Equally, do not wait weeks to discover that the production template still emits the old directive.

Record decisions that reject a recommendation

A review is still useful when the team decides not to implement a finding. Record the reason: low reach, weak confidence, unacceptable user impact, platform constraint or higher-priority work. Add a trigger for reconsideration, such as growth beyond a URL threshold or a future migration. This prevents the same issue from being rediscovered without the context behind the original decision.

Close the loop with ownership

Assign one owner for implementation and another, where possible, for validation. Define the release marker, expected observation window and reporting location. A recommendation without ownership becomes an archive; a recommendation with a measurable test becomes an operating change. The final record should say what happened, what remained uncertain and which evidence would justify another iteration.

Document the smallest useful next test

When evidence remains incomplete, avoid turning uncertainty into a broad recommendation. Specify the smallest reversible test that can distinguish competing explanations, the URLs included, the observation period and the condition for stopping. Small tests protect users and engineering time while producing evidence that a later team can understand. Record negative results as carefully as positive ones; they narrow the system boundary and prevent repeated work.

Limits and interpretation

Search platform reports are sampled, delayed and interpreted by systems outside the site owner’s control. A clean technical implementation does not guarantee indexing, traffic or rankings. Treat recommendations as risk-reduction and diagnostic work, then validate changes against stable cohorts and business outcomes.