The (un)Common Logic Checklist for Site Migrations
Migrations do no longer fail thanks to one individual forgets a redirect. They fail while dozens of small assumptions collide on unlock day and blunt the momentum you spent months building. Over the final decade I certainly have helped agencies action lots and hundreds and hundreds of URLs across replatforms, redesigns, and rebrands. The helpful ones look dull from the backyard, for the reason that every likelihood is known as, planned for, and rehearsed. The messy ones share a style too, improvised picks less than pressure that ripple attributable to website online viewers, conversions, and morale.
I wrote this file to preclude the messy sort. It blends technical search engine advertising, analytics, product leadership, and operations, and it displays what an skilled staff at (un)Common Logic asks forward of they located a date at the calendar. Treat it as a residing file. Your stack, your constraints, and your targets may still track the info, but the trouble-free sense holds in the time of industries.
What you might be migrating, and why that mattersPeople say website online migration as if it had been a unmarried tournament. In actuality, it describes a handful of very the different projects.
A replatform moves the backend, equivalent to from a custom-made .NET app to Shopify or from Drupal to headless. Expect transformations in URL styles, rendering, caching, and permissions. website positioning menace is mild to top, driven with the reduction of technical parity and the way neatly you map legacy routes.
A redesign alterations templates, navigations, and motives. seo danger skews in the direction of inside linking and content material materials visibility, which consist of Core Web Vitals and accessibility. Conversions can bypass plenty true the following, for more effectual or worse.
A rebrand variations names, domains, and messaging. The area alternate brings the maximum priceless single website online positioning chance on the desk. If finished nicely, we see 85 to 95 % of suit company retained inside the first four to eight weeks, https://jsbin.com/gobiyowaxa with the the rest commonly returning due to the 12 week mark. If the mannequin repositioning furthermore trims content, look forward to a longer restoration.
An information architecture overhaul reorganizes categories and hubs. seek engine advertising and marketing risk is based on how your lots related content is treated. Expect flux as Google crawls, consolidates signs, and reassigns canonical importance.
Hybrids display up slightly occasionally. A store combines replatforming and IA modifications. A SaaS organization rebrands when rolling out a factor library. The added fronts you open in an instant, the more suitable time you want to level, scan, and degree.
The stakes, in plain numbersOne buyer moved one hundred twenty,000 product pages to a brand new ecommerce stack. The mushy unlock environment handed spot exams, however the live CDN cached 302s from old PDPs to type pages, and the redirects truely no longer upgraded to 301 at the threshold. Crawl budgets went to waste. Rankings fell on mid tail product words. It took 7 weeks and a whole lot of pressure to unwind. That one caching header mismatch rate kind of 18 %. of healthy profits for 2 quarters.
On the opposite aspect, an producer B2B utility seller merged two domains into one. They staged redirects for every one and each legacy path, preserved inside anchor text, and pre warmed sitemaps. Within three weeks, 90 two percentage of non branded visitors to come back. Within 10 weeks, the consolidated web content online turned into up 12 percentage YoY, with fewer pages and more effective inside hyperlink equity.
Those effects may still now not remarkable fortune. They comply with from small print that companies can control.
Timeline sanity checkBackward plan from a incredibly release window. Put immovable events on the calendar, like height season, worthy advert campaigns, financial closes, code freezes, and staffing constraints. A mid sized migration covering five,000 to 50,000 URLs primarily calls for 10 to 16 weeks from kickoff to launch if the codebase already exists, longer for people that are still pattern. Shorter timelines pressure exchange offs. If you is not really going to do the entirety, favor the very best concerns.
For significant catalogs, move slowly and mapping projects by myself can devour 2 to a few weeks, notwithstanding automation. Vendor lead situations for SSL, DNS, and security opinions over and over surprise more moderen businesses. Legal approvals for cookies and consent banners move on their non-public time table. Pad time circular the ones.

Start with a comprehensive move slowly of the present day web site, with rendering in which wanted. Capture URL inventory, canonical tags, titles, meta descriptions, hreflang, robots directives, dependent history, within links, pagination, and status codes. Add functionality timing for key templates on both individual personal computer and cellphone. You are rising a baseline.
Pull your analytics and are seeking for info, phase with the support of template versions and rationale layers. Revenue or lead worthy as a result of course, assisted conversions, biological landing pages, and look for queries. Identify the ten % of URLs that tension 80 % of lessons or fee. These are your purple routes. Changes that affect them purchase deeper scrutiny, in advance trying out, and redundant assessments.
Inventory lower back-links in your top content material textile and different types. Save copies of your much connected assets. If your appropriate assist on cloud security has 3,000 referring domain names, you do something about that URL like a crown jewel, secure its slug, and keep the first reveal of content subject matter.
Finally, define what will change and what is going to now not. If you might be in a position to continue slugs reliable all around a replatform, do it. Stability reduces redirect complexity and preserves relevance indicators. If you could modification patterns, structure recommendations early and record them.
URL mapping just is simply not simply to discover and replaceI also have noticeable migrations where groups used regex to seriously amendment tens of hundreds of URLs in mins. The speed felt entertaining. The aftermath did no longer. Good mappings are both systematic and opinionated. You want legislation, and also you want exceptions.
Start with templated regulations, like legacy /cyber web ebook/yyyy/mm/title to /equipment/establish, however carve out over the top magnitude pages to be able to must keep their slugs or stream to committed hubs. Use a mapping table that includes ancient URL, new URL, redirect type, canonical reason, and notes. Enforce one hop redirects. Two hops bleed stream slowly price range and enlarge the opportunity of loops and chains. If your CMS enforces trailing slashes or lowercase pretty much, bake that into the mappings so that you do now not create duplicate routes.
Pay cognizance to question parameters. If your old online page depended on parameters for filters, and the new web page uses facet paths, map representative editions to the nearest new canonical, and then block crawling of endless combinations with robots rules or nofollow on non canonical hyperlinks. For PPC and social, coordinate UTM handling so analytics attribution survives.
Redirect method at the edgeRedirects belong as just about about the neighborhood side as that you simply would be able to attend to, no longer buried in application favourite sense. Edge redirects do away with dependencies on code deploys, lessen latency, and live to tell the tale application mess ups. Use 301 for permanent strikes. Reserve 302 for staging or restrained time reroutes you want to do away with. Avoid meta refresh or JavaScript redirects, they waste movement slowly and underperform for prospects.
Test redirects equally techniques. Crawl vintage URLs to ascertain they land as quickly as, with a 301 direct hit on the brand new excursion spot. Then move slowly the new website online to look whether or not internal hyperlinks despite the fact that detail at historical routes. Every interior hyperlink that hits a redirect is self inflicted friction. Clean them in templates, navs, sitemaps, and footers.
CDNs ordinarilly cache 301 and 302 in a different way. Coordinate which includes your CDN group on TTLs and purge strategies. Document who can invalidate caches on launch day, and what fallbacks exist if the vital individual is unavailable.
Content parity, cannibalization, and toneContent parity does not mean copying each and every sentence into a cutting-edge template. It capacity maintaining the purpose, policy canopy, and page point strong point that earned you scores and links. When companies condense a 2,000 be aware product cyber web page into 500 words easily due to the fact a brand new design favors white domain, conversion fees maximum probably dip. Search rankings can train. Run managed checks in shrink site friends different types in the past rolling a pattern throughout your catalog.
Watch for cannibalization. New hubs, tags, and filters can create distinctive pages centred at the identical question space. Clarify canonical targets at the template level. If you introduce a impressive resource hub for cloud renovation and already have an extended running cyber web booklet series on the identical difficulty, consolidate or differentiate. A sometimes used mind-set is to build a canonical practise with tangible subtopics, and then link in depth posts as young children with man or woman intents.
Tone shifts depend too. During a rebrand, advertising and marketing agencies refine voice. Preserve key phrases that customers and clients use, awfully in headlines, h1s, and primary paragraphs. Searchers write of their personal language, no longer yours. Meet them there.
Technical web optimization essentialsYou can show ahead 90 percentage of your online page positioning posture with habits that during no way make the press loose up. Keep self referencing canonicals on indexable pages. Use hreflang whereby it already exists, and do now not broaden it on launch day unless you can also have time to validate reciprocals and language codes. Retain pagination patterns valued clientele and spiders can prepare. Strong within linking beats problematical XML for discovery, yet sitemaps still rely number. Generate new sitemaps tied to the hot routes, impede doc sizes underneath limits, and submit them in Search Console simply after liberate site visitors begins to transport.
Handle robots.txt carefully. Stage environments in most cases comprise Disallow policies and IP blocks. Before release, audit the robots record that will set up to manufacturing. Add a calendar take care of to remove noindex headers, meta tags, and server point auth within the experience that they have been used in staging. It sounds glaring, but the number of launches delayed with the relief of a single leftover noindex is greater than greatest admit.
For established pointers, replicate what labored, and upload improvements only within the occasion that they validate cleanly in staging with live like data. Schema can suggestions, yet 1/2 baked markup triggers signals and diverts cognizance effectively whereas the team needs calm.
Analytics, tagging, and consentMigrations ruin analytics added in the main than they wreck ratings. The reasons are predictable. Changes to DOM buildings break click on tracking. SPA transitions modify pageview exceptional judgment. Consent structures change experience timing. Tag Manager box snippets wander off in template refactors. Fix these within the beyond launch.
Decide even with even if it is straightforward to shelter historical continuity with the reduction of retaining the identical GA4 assets and measurement protocol, or initiating present day. For such quite a bit manufacturers, continuity wins, yet it calls for cautious feel name mapping and parameter parity. Document the dozen or so activities that pressure relatively judgements, like style submissions, demo bookings, upload to carts, and checkouts. Validate them in staging with live like site viewers.
Cookie consent requires permitted and UX layout, no longer just a script. Test geography headquartered behavior when you occur to operate in distinct jurisdictions. Make yes autoconsent or cookie partitions do not conceal key CTAs by accident on small displays.
Performance and Core Web VitalsA vibrant redesign that provides blocking scripts, invisible carousels, and unoptimized media can erase exhausting gained search engine optimization favourable houses. Measure Largest Contentful Paint, Cumulative Layout Shift, and Interaction to Next Paint in staging on reliable gadgets. Favor server section rendering or as a minimum HTML with significant placeholders over heavy client aspect hydration. Lazy load media shrink than the fold, inline serious CSS, and delay non widespread scripts.

I greatly have a tendency to finances for performance early, not late. Set thresholds on your heaviest templates, like PDPs and really good resource articles. If your pre migration LCP averaged 2.3 seconds on phone, lock a purpose huge selection and determine designs and features opposed to it. Explain to stakeholders that those 4 hundred milliseconds will also be the tremendous big difference between a cross and a fail on lab exams, and that lab general overall performance tracks conversion, now not purely ratings.
Internationalization, subdomains, and a couple of marketsGlobal websites upload complexity. When migrating multilingual or multi marketplace homes, draw a sparkling map of language and space relationships. Keep language codes consistent, and shop splitting a language throughout multiple ideal diploma domain names with no a successful purpose. If you consolidate from ccTLDs to subdirectories, continue dedicated sitemaps in keeping with marketplace, and be sure hreflang constituents to the recent routes with reciprocity.
Edge case, may want to you might be relocating a language from a subdomain to a record, like de.illustration.com to example.com/de, appear in advance to supply loading that also ingredients to the antique subdomain. Mixed supply origins create latency and CORS concerns which perhaps hard to debug under force.
Accessibility shouldn't be very optionalA migration is a danger to enhance accessibility. It additionally introduces hazard. Alt text, heading hierarchies, awareness management, and kind labels on the whole regress while templates alternate. Run audits with a exhibit reader and automatic machine, however also with a human who is predicated on assistive tech. If your consent banner traps core of cognizance or your new mega menu is easily now not navigable by keyboard, you are going to be able to frustrate users and injury potency. Search engines notice when shoppers leap with the useful resource of unusable interfaces.
Security, privacy, and criminal reviewsSSL might be desk stakes. Yet certificate expire, and redirects from http to https regress throughout the chaos of launch. Confirm HSTS guidelines, mixed content assessments, and CSP settings. If you exchange cookie scope with the aid of way of domain ameliorations, update SameSite and Secure attributes. Legal groups should nevertheless sign off on privateness coverage updates required by using new tracking or information processing.
Security groups virtually necessarily upload headers in the load balancer or CDN layer. Coordinate to examine those headers do no longer break scripts you need on launch day. Again, file who has keys to regulate those settings if pressing changes are required.
Environments, records, and rehearsalStaging parity saves launches. If staging makes use of exclusive domain names, decide all absolute hyperlinks work out and do not leak into construction. Sanitize details, then again keep good enough reality to match facet cases. For ecommerce, seed carts with combos of versions, coupons, and delivery approaches. For SaaS, have a look at account states like trial, expired, and agency.
Run a robe practice consultation. Pick a slice of URLs, direction them through the whole redirect and caching layers, turn function flags, and watch logs. A canary liberate teaches you the place the surprises reside. You analyze regardless of whether DNS TTLs behave, regardless of regardless of whether your WAF blocks danger unfastened requests, and regardless of even if your build pipeline deploys the ideal artifacts you assume.
The two checklists that ward off you honestLaunches create adrenaline, and adrenaline degrades memory. Write down the smallest steps. Keep similarly checklists brief, and empower any grownup to examine them out loud throughout the war room.
Pre liberate file:
Redirect mappings masking 100% of legacy indexable URLs, with one hop fullyyt, proven via crawl Robots.txt, meta robots, and headers audited for noindex, with staging blocks removed and production file approved Analytics and party monitoring established in staging, with consent banner conduct established in all objective regions Sitemaps generated for latest routes, with large templates measured for Core Web Vitals in the direction of targets DNS, SSL, CDN and cache purge techniques documented, which incorporate who has get exact of access to and a backout planPost unencumber checklist, first forty eight hours:
Compare stay site viewers and conversions using hour opposed to a modern comparable length, segmented with the help of channel and fascinating touchdown pages Crawl a representative sample of vintage and new URLs to envision redirect healthiness, canonical tags, and interior links with out redirect hops Monitor 404s and 5xx in server logs and Search Console, triage immoderate extent styles first Submit new sitemaps, fetch and render precedence pages, and spot resolve indexation signals Track Core Web Vitals with RUM if available, and join the maximum apparent regressions in a timely fashion, which come with uncompressed hero images or blocking off scriptsLimit these lists to the requirements. Everything else belongs in runbooks and clinical medical doctors that unbelievable proprietors execute.
Communication beats heroicsTreat the migration like a free up train. Publish a plain language plan for advertisements, gross sales, strengthen, and executives. Set expectancies that website traffic also can differ for a number of weeks, and that fluctuation does no longer similar failure if most useful indicators glance tournament. Share the backout standards, for instance, if considered necessary checkout blunders exceed a detailed threshold for more desirable than 0.5 an hour, we revert to the historical stack.
Decide how one may want to update stakeholders on unlock day, along with a committed channel with swift, universal notes. Avoid assembly pileups. A 10 minute standup each and every two hours is normally adequate. When men and women realize the plan, they understand the means and discontinue peppering the personnel with part requests.
Monitoring that mattersDashboards will must exhibit signal, not noise. During the first week, track organic periods for your red routes, income or leads via employing hour, precise error codes, and the ratio of branded to non branded queries. Watch stream slowly stats in Search Console, highly crawl requests by using method of response code and purpose. If you see a spike in found, not indexed, audit your inner links and canonical tags, then re submit sitemaps.
Log level visibility facilitates. If you may have get admission to to uncooked logs, look for requests to legacy URLs that don't acquire a 301, grownup agents that signify are searching for engine crawlers getting throttled, and exotic spikes in 404s from individual referrers. Often, a unmarried out of doors link or companion integration drives a substantial proportion of bad site visitors to ancient resources.
Recovery playbook for while web site friends dipsEven wary migrations most likely dip. If you lose excess than 20 to twenty-five % of non branded web page site visitors after the first two weeks, pull the healing plan.
First, ascertain technical fundamentals. Status codes, redirects, canonicals, robots rules, and sitemaps. If all seem to be blank, circulation to content material subject matter and interior linking. Reinforce your canonical pages with glowing internal hyperlinks from associated content material and excessive authority hubs. Update sitemaps to prioritize lately improved pages. Submit URL inspection for a development of precedence pages to nudge re crawling.
If a site trade is interested, wait for an extended lag. Keep promotion the new region thru PR, newsletters, and partnerships. Update correct charge outdoors hyperlinks the place you have you have bought relationships. If you trimmed content material aggressively true because of a redecorate, restore a subset of got rid of sections for your purple routes, measure the influence, and then prune more deliberately over the years.
Finally, check up on conversions. If you saved visitors but misplaced coins, your point is most likely UX or monitoring, not website online positioning. Heatmaps and session recordings can decide on out regressions in paperwork, CTAs, and navigation.
Tooling that speeds you up with out blinding youUse a crawler capable of JavaScript rendering where major, and avert snapshots of pre and submit launch crawls. Search Console continues to be the such a lot pleasant unmarried aid for indexation signals. Pair it with log research or no much less than house analytics out of your CDN. For capability, integrate Lab assessments in CI, and use RUM to lure field understanding after release.
Simple scripts lend a hand too. A small script to validate one hop redirects right through all legacy URLs has saved me days. Another script that compares identify and h1 parity between earlier and new sites can give up unintended key-phrase drift. Do not over automate novelty, automate the uninteresting exams that you could possibly miss at 2 a.m.
Common pitfalls I still seeTeams eradicate skinny pages and are expecting rankings to consolidate, however the new topology starves hooked up pages of indoors hyperlinks, so consolidation in no way happens. Solve by way of due to holding up navigational pathways and adding context links inside of content material textile.
Sitemaps pass dwell too early with staging URLs, or too late after discovery has already lagged. Time them to the release and sanity study the hostnames.
Everyone treats smartphone and computing device the same, then wonders why cellular phone conversion worth fell inspite of same web page visitors. Test mobile types, sticky CTAs, and input styles.
Legal indications off on a consent banner that obscures the first heading on small screens. Your start value rises on telephone biological. Adjust visual priority and area.
A single 0.33 get together script tanks your LCP on hero pages. Defer it, load it conditionally, or drop it. Your emblem will not disintegrate with out but an extra slider.
Governance and ownershipThe so much useful listing in a migration is a effortless RACI. Who owns redirects, sitemaps, robots, analytics, DNS, CDN, and backouts. List names, not teams. Include backups. Post it within which virtually all of us can see it. When whatever thing issue breaks, you need a temporary route to the one which may restore it, not a scavenger hunt.
Post release, assign stewardship for ongoing hygiene. Redirect information accrete cruft. Sitemaps waft. New content material fabric templates take position with out SEO overview. Create a cadence for audits each one quarter. Make it every body’s endeavor.
What a calm unlock appears likeIf you walked right into a peaceful liberate, you'll be able to probable see a struggle room with a small community, every with a slim focal element. The redirect proprietor runs the pass slowly diff and confirms suits. The analytics lead watches are residing hobbies and salary, and checks consent habits. The search engine optimization lead reflects indexing indicators and fetches. The engineer with CDN access handles purges and header tweaks. The product proprietor communicates status upstream and makes the determination while trade offs emerge.
There is chatter, nevertheless it not panic. Someone notices a spike in 404s from a retired weblog class. The mapping desk missed several slugs with the various characters. The restoration is small, the edge solutions replace in minutes, and the spike subsides. Traffic holds nearly forecast. The crew leaves tired but intact.
That calm significantly is simply not fulfillment. It is the final result of unglamorous guidelines guided by way of experience. At (un)Common Logic, we comedian story that our absolute most reliable migration stories are boring. The charts slope calmly, the dashboards stay green, and a month later that's important to remind workers that the so much worthwhile technical venture of the region already occurred.
If your next migration is at the horizon, treat this checklist like a contract with your self. Clarify what you're changing and why, map your routes with care, put redirects at the brink, look after the content that works, choose analytics before you send, and rehearse. Do those, and you are within the quiet majority who send with self assurance and save relocating.