Migrating to Wix Harmony without losing SEO rankings: the complete guide

Migrating your Wix site to the Harmony editor is increasingly unavoidable as Wix phases out the classic Editor. But editor migrations are one of the highest-risk activities in SEO because any change to URLs, page structure, meta tags, or rendering can cause ranking drops that take months to recover from. This lesson provides the complete migration playbook used by professional SEO consultants: a systematic process for auditing your current site, executing the migration safely, and monitoring for issues in the critical weeks that follow.

Why Harmony Migration Carries SEO Risk

When you migrate from the classic Editor to Harmony, Wix converts your page structure from absolute-positioned elements to section-based Flexbox layouts. This conversion changes the DOM structure of every page on your site. While your URLs should remain the same, the underlying HTML that Googlebot crawls is different. Changes in DOM structure can affect how Google interprets your content hierarchy, which elements it considers primary content versus secondary, and how it evaluates page experience signals.

The secondary risk involves SEO settings. Meta tags configured through the Wix SEO panel should transfer automatically, but SEO Patterns, custom Velo code, third-party app integrations, and manually configured structured data all need verification after migration. A single missed canonical tag or broken SEO Pattern can affect hundreds of dynamic pages.

Phase 1: Pre-Migration SEO Audit

Before touching the migration button, you need a complete snapshot of your current SEO state. This baseline data is essential for detecting any issues after migration and measuring whether the migration improved or degraded your search performance.

Complete pre-migration audit checklist

• Export a full list of all page URLs from your current site. Use Screaming Frog or the Wix URL Redirect Manager to get every URL. Save this in a spreadsheet with columns for URL, page title, meta description, and H1 heading.
• Run a crawl of your entire site with Screaming Frog or Sitebulb. Export the crawl data including response codes, canonical tags, meta robots directives, heading hierarchy, and internal link counts for every page.
• Export Google Search Console performance data for the last 6 months. Download queries, pages, impressions, clicks, and average positions. This is your ranking baseline.
• Screenshot your Google Analytics 4 key metrics: organic sessions, top landing pages, bounce rate, and engagement rate. These are your traffic baseline.
• Document all SEO Patterns configured for dynamic CMS pages. Screenshot the pattern templates for page titles, meta descriptions, and URL slugs.
• List all custom Velo code that manages SEO elements. Copy the code for any wix-seo API calls, structured data injection, or dynamic canonical URL logic.
• Document all 301 redirects in the Wix URL Redirect Manager. Export the full redirect list as your safety backup.
• Run PageSpeed Insights on your top 10 pages by organic traffic. Record LCP, INP, CLS, and the overall performance score for each.
• Check all third-party apps installed on your site. Note which ones inject code, modify headers, or add structured data. Verify these apps are compatible with Harmony.
• Take full-page screenshots of your top 10 pages on both desktop and mobile. These visual references help you spot layout issues after migration.

Phase 2: Executing the Migration

Wix typically offers two migration paths: automatic migration where Wix converts your site in place, or manual rebuild where you create a new Harmony site and transfer content. The automatic path preserves more SEO settings but gives you less control over the result. The manual path lets you optimise the new structure but requires careful URL and redirect management.

For sites with significant organic traffic, the automatic migration is generally safer because it preserves URL structure by default. If you choose the manual rebuild path, you must ensure every existing URL either continues to work on the new site or has a 301 redirect to the equivalent new URL. Any URL that returns a 404 after migration will lose its rankings and accumulated link equity.

• If using automatic migration, accept the conversion and immediately begin Phase 3 verification. Do not make any design changes until you have confirmed all SEO elements are intact.
• If using manual rebuild, build the new Harmony site as a separate project first. Map every old URL to its new equivalent. Set up 301 redirects for any URLs that change.
• Never migrate during peak traffic periods. Choose a low-traffic day and time so any issues affect the minimum number of users and search engine crawls.
• Keep your old site backup accessible for at least 90 days after migration in case you need to reference original content, code, or settings.

Phase 3: Post-Migration SEO Verification

The first 48 hours after migration are critical. You need to systematically verify every SEO element against your pre-migration audit data. Do not assume anything transferred correctly; verify everything explicitly.

Post-migration verification checklist

• Re-crawl your entire site with Screaming Frog and compare the results to your pre-migration crawl. Check for new 404 errors, changed canonical tags, missing meta tags, or altered heading structures.
• Verify every page URL loads correctly. Compare the live URL list against your pre-migration URL export. Any missing URLs need immediate 301 redirects.
• Check all SEO Patterns on dynamic CMS pages. Visit at least 5 pages from each CMS collection and verify the page title, meta description, and URL slug are generating correctly.
• Test all Velo SEO code. If you had custom meta tag generation, structured data injection, or canonical URL logic, verify each function produces the correct output on the Harmony site.
• Validate structured data on key pages using Google Rich Results Test. Compare the results to your pre-migration structured data to ensure no schema has been lost.
• Verify all 301 redirects are working. Test each redirect from your exported list to confirm it resolves to the correct destination.
• Run PageSpeed Insights on the same top 10 pages and compare Core Web Vitals scores to your baseline. Harmony should generally improve scores, but verify this is actually the case.
• Submit your sitemap in Google Search Console to prompt Googlebot to recrawl your site with the new structure.
• Check the Coverage report in Search Console daily for the first 2 weeks. Watch for any increase in excluded pages, crawl errors, or indexation warnings.
• Monitor organic traffic in GA4 daily for the first 30 days. Compare week-over-week to the same period before migration to detect any traffic drops.

Common Migration Issues and How to Fix Them

The most common post-migration SEO issue is changed heading hierarchy. Harmony may restructure the DOM so that headings appear in a different order than the classic Editor version. Check the H1-H6 hierarchy on every page type and correct any issues in the Harmony editor. A page with two H1 headings or a jump from H1 to H4 needs immediate attention.

The second most common issue is broken internal links. If your internal links used absolute URLs that reference the old editor preview domain, they may break after migration. Update all internal links to use relative paths or your live domain URL. Check all menu links, footer links, and in-content links across the site.

• Missing alt text: Harmony migration may clear image alt text in some cases. Re-audit all images and restore descriptive alt text where missing.
• Broken third-party app integrations: some Wix apps may not yet support Harmony. Check that review widgets, chat plugins, and analytics scripts are loading correctly.
• Changed font rendering: Harmony may load fonts differently, affecting Largest Contentful Paint if a large heading uses a custom font. Test and adjust font loading strategy if LCP regresses.
• Lost custom CSS: any custom CSS injected via the classic Editor developer tools may not carry over. Recreate custom styles in Harmony.

The 30-Day Post-Migration Monitoring Calendar

Recovery from a site migration follows a predictable pattern. Rankings typically dip slightly in week 1 as Google recrawls the new page structures. Weeks 2 and 3 usually show recovery to baseline levels. By week 4, most sites return to pre-migration performance or better, assuming no technical issues persist.

• Days 1 to 3: Check Search Console for crawl errors daily. Verify no pages have been deindexed. Monitor server logs for Googlebot crawl activity.
• Days 4 to 7: Review initial ranking data in your rank tracking tool. Minor fluctuations are expected and not cause for concern.
• Days 8 to 14: Compare organic traffic week-over-week. If traffic is down more than 20 percent, investigate specific pages that lost traffic and check their technical SEO.
• Days 15 to 21: Rankings should be stabilising. Re-run your full site crawl and compare to the post-migration crawl to detect any new issues.
• Days 22 to 30: Final assessment. Compare all metrics to your pre-migration baseline. Document the migration outcome and any remaining issues to address.