[{"data":1,"prerenderedAt":78},["ShallowReactive",2],{"iTuu9eEkG9":3,"related-migration-notes/how-to-prepare-for-a-headless-migration":27},{"id":4,"slug":5,"title":6,"excerpt":7,"meta_title":6,"meta_description":8,"page_content":9,"featured_image":17,"fields":18,"tags":20,"published":23,"published_at":24,"created_at":25,"updated_at":26},"a37829af-97a7-4820-a99b-9ae9e483f32b","notes/how-to-prepare-for-a-headless-migration","How to Prepare for a Headless Migration","Most migrations that go badly went badly before anyone wrote a line of code. The non technical homework to do before you move to a headless setup, from URL mapping to who enters the content.","The non technical homework before a headless migration: inventory, what to keep, URL mapping, redirects, integrations, content entry, access and sign-off.",{"blocks":10},[11],{"id":12,"data":13,"type":16},"02e85b6e-eca5-4038-bfde-4907c8a7b971",{"content":14,"maxWidth":15},"\u003Cp>Most migrations that go badly went badly before anyone wrote a line of code. The build itself is rarely the hard part. The mess comes from decisions that nobody made, content nobody looked at, and access nobody chased up until the week it was needed. I have run enough of these to know that the projects that go smoothly are the ones where the client did a bit of homework first. So here is the honest, non technical list of what to sort out before you move to a headless setup, whoever ends up doing the actual work.\u003C/p>\u003Ch2>Take an honest inventory of what you have\u003C/h2>\u003Cp>You cannot move what you have not counted. Before anything else, get a real list of your pages, your products if you sell things, your blog posts, and any of the odd corners that have built up over the years. Most sites have far more than the owner thinks. Old campaign pages, three near identical about pages, a blog that stopped in 2021. Seeing it written down is usually the first time anyone has looked at the whole thing at once, and it changes the size of the job in either direction.\u003C/p>\u003Ch2>Decide what moves, what gets rebuilt, and what gets binned\u003C/h2>\u003Cp>Not everything deserves to come with you. A migration is the best chance you will ever get to throw away the pages nobody visits and the features you added once and never used. Go through that inventory and mark each thing as keep, rebuild, or drop. Keep is content that comes across roughly as it is. Rebuild is the stuff that needs rethinking because it was awkward on the old site anyway. Drop is the dead weight. Doing this early means you are paying to move a leaner, better site rather than carting the clutter across and tidying up later, which never happens.\u003C/p>\u003Ch2>Map every URL you actually care about\u003C/h2>\u003Cp>This is the step people skip and regret. Every page that has a decent search ranking or gets linked to from elsewhere has an address, and if that address changes without a redirect, the traffic to it can disappear. Before the build starts, pull a list of your current URLs, especially the ones that bring in visitors, and plan where each one lands on the new site. Where an address changes, you want a redirect from the old one to the new one. Get this right and a migration barely dents your rankings. Get it wrong and you spend the next three months wondering where your visitors went. I wrote separately about whether \u003Ca href=\"/notes/does-going-headless-hurt-your-seo\">going headless hurts your SEO\u003C/a>, and this redirect work is most of the answer.\u003C/p>\u003Ch2>Remember the site is more than pages\u003C/h2>\u003Cp>The visible pages are only half of it. Think about everything the current site quietly does. The contact form that emails you, the booking or payment flow, the newsletter signup, the reviews widget, whatever feeds your stock levels. Each of those needs a home on the new setup, and each is a small decision. Some you keep as they are, some you swap for something better, some you find you no longer need. The ones that catch people out are always the invisible ones, the integration with an accounts system or a supplier feed that only one person remembers exists. List them now, not when something stops working after go live.\u003C/p>\u003Ch2>Decide who is going to enter the content\u003C/h2>\u003Cp>Someone has to put the content into the new system, and that someone costs either time or money. This is one of the biggest swings in how much a migration ends up costing, so decide it deliberately. If your team does the content entry, it is cheaper but slower and needs a clear handover so they know how. If the developer does it, it is faster and tidier but you are paying for the hours. There is no wrong answer, but there is a wrong way, which is to leave it unspoken until the site is built and empty and everyone assumes the other person was doing it.\u003C/p>\u003Ch2>Gather your access before day one\u003C/h2>\u003Cp>Nothing stalls a migration like waiting on a login. Your domain name, your current hosting, your analytics, your email setup, any third party accounts the site talks to. Someone needs the keys to all of it, and on older sites those logins are often scattered across a former employee, an agency that no longer answers, and a personal email account. Chasing them down can take longer than the build. Round them up early, before the clock is ticking, so the switch over is a quiet afternoon rather than a scramble.\u003C/p>\u003Ch2>Agree what finished actually means\u003C/h2>\u003Cp>Write down, in plain words, what you expect to be true when the project is done. The old links redirect. The forms send email to the right place. Someone on your team can edit the site without calling anyone. Analytics is still recording. It sounds obvious, but a shared checklist is what stops a migration being called finished when it is only half done. It also gives you and whoever built it the same picture of success, which is worth more than any contract clause.\u003C/p>\u003Cp>None of this is technical, and that is the point. The build is a job for a developer, but the preparation is a job for you, and the two together are what make a migration calm instead of chaotic. If you want a sense of the money and time involved once you have done this groundwork, I went through that in \u003Ca href=\"/notes/what-a-headless-migration-costs-and-how-long-it-takes\">what a headless migration costs and how long it takes\u003C/a>, and for the shape of the work itself there is \u003Ca href=\"/notes/what-a-shopify-to-headless-migration-actually-involves\">what a Shopify to headless migration actually involves\u003C/a>. I did all of this to my own work when I moved off Magento, which I wrote about in \u003Ca href=\"/notes/why-i-moved-from-magento-to-headless\">this note\u003C/a>. If you would rather have someone walk through your own site with you before you commit to moving it, that is the kind of thing I \u003Ca href=\"/services\">help with\u003C/a>.\u003C/p>","lg","wysiwyg","",{"author":19},"Adam Jackson",[21,22],"headless","migration",true,"2026-09-17T08:00:00+00:00","2026-07-19T11:43:16.955159+00:00","2026-10-01T19:41:42.773395+00:00",[28,31,42,55,67],{"id":4,"slug":5,"title":6,"excerpt":7,"meta_title":6,"meta_description":8,"featured_image":17,"fields":29,"tags":30,"published":23,"published_at":24,"created_at":25,"updated_at":26},{"author":19},[21,22],{"id":32,"slug":33,"title":34,"excerpt":35,"meta_title":36,"meta_description":37,"featured_image":17,"fields":38,"tags":39,"published":23,"published_at":40,"created_at":41,"updated_at":26},"c1de902a-b7ff-43ee-900a-9772de9b8986","notes/what-a-headless-migration-costs-and-how-long-it-takes","What a Headless Migration Costs, and How Long It Takes","The two questions I get in every first conversation. An honest look at what really drives the cost and the timeline of a headless migration, and how to keep both down.","What a Headless Migration Costs and Takes","What really drives the cost and timeline of a headless migration: content, integrations, custom front-end, and how to keep the bill down.",{"author":19},[21,22],"2026-08-13T08:00:00+00:00","2026-07-12T08:01:55.761553+00:00",{"id":43,"slug":44,"title":45,"excerpt":46,"meta_title":47,"meta_description":48,"featured_image":17,"fields":49,"tags":50,"published":23,"published_at":52,"created_at":53,"updated_at":54},"3e1b5ff2-28a8-4ce3-907c-5bc129c9ca45","notes/moving-from-bigcommerce-to-a-headless-cms","Moving from BigCommerce to a headless setup","BigCommerce is one of the few SaaS platforms actually built to go headless, so the real question is rarely how to escape it. It is whether you keep it as the backend or leave it entirely. Here is how I decide.","Moving from BigCommerce to a Headless Setup","BigCommerce is built for headless, so the real choice is keep it as the backend or leave entirely. How each works, the checkout catch, and which to pick.",{},[21,22,51],"ecommerce","2026-09-10T08:00:00+00:00","2026-07-03T07:15:00+00:00","2026-10-01T15:34:16.57272+00:00",{"id":56,"slug":57,"title":58,"excerpt":59,"meta_title":60,"meta_description":61,"featured_image":17,"fields":62,"tags":63,"published":23,"published_at":64,"created_at":65,"updated_at":66},"05ffd0ba-0160-412c-b711-1c563941fcfb","notes/moving-from-wix-to-a-headless-cms","Moving from Wix to a headless setup","Wix is the most closed builder I deal with, so a move is mostly a rebuild, not a transfer. What that actually involves, what you gain, and when to stay put.","Moving from Wix to a Headless Setup","What a Wix to headless move actually involves: why there is no clean export, what you rebuild, what you gain in speed and SEO, and when to bother.",{},[21,22],"2026-08-06T08:00:00+00:00","2026-07-02T07:09:36+00:00","2026-10-01T15:34:16.367577+00:00",{"id":68,"slug":69,"title":70,"excerpt":71,"meta_title":72,"meta_description":73,"featured_image":17,"fields":74,"tags":75,"published":23,"published_at":76,"created_at":77,"updated_at":26},"623c0373-ffaf-45a8-a62e-0c985d7ef829","notes/migrating-from-squarespace-to-a-headless-cms","What Moving a Squarespace Site to a Headless CMS Really Involves","People picture a theme swap. Moving off Squarespace to a headless CMS is a full rebuild plus quietly owning the forms, hosting, SEO and content export Squarespace handled for you.","Squarespace to Headless CMS: What It Involves","Migrating from Squarespace to a headless CMS is a full rebuild plus owning the forms, hosting, SEO and content export Squarespace did for you.",{"author":19},[21,22],"2026-08-03T08:00:00+00:00","2026-06-30T07:14:26+00:00",1792137658314]