--- title: "How to Switch to Waggle from Yoast, Rank Math, or All in One SEO" url: "https://plugpress.co/docs/waggle-migrating-from-another-seo-plugin.md" canonical: "https://plugpress.co/docs/waggle-migrating-from-another-seo-plugin/" published: "2026-07-28" modified: "2026-07-28" author: "Fahim" tags: - "Waggle" --- # How to Switch to Waggle from Yoast, Rank Math, or All in One SEO **Waggle imports your existing SEO data in three steps, and shows you exactly what will change before it changes anything.** Go to **Settings → Import**, pick your old plugin, press Preview, and you get a per-field list of what would be copied across. Nothing is written until you press Migrate. The import is **non-destructive and safe to re-run**. Waggle states the guarantee on the Import screen itself: > Migration only fills empty Waggle fields. Anything you already set in Waggle stays exactly as it is — so re-running is safe. It never overwrites a value you have already set. If you migrate, edit a few titles by hand, then run the import again, your edits survive. ## What gets imported? Waggle reads the meta your old plugin stored on each post and maps it to its own fields: | From your old plugin | Becomes in Waggle | | --- | --- | | SEO title | SEO Title | | Meta description | Meta Description | | Focus keyword(s) | Focus Keywords | | Canonical URL | Canonical URL | | Open Graph / social title and description | Social title, Social description | | Social share image | Social Image | | `noindex` robots setting | Hide from search engines | Supported sources are **Yoast SEO**, **Rank Math** and **All in One SEO**. Waggle reads each plugin's own meta keys directly from the database, so nothing depends on the old plugin still being active at import time. ## How do I run the import? ![Waggle's Import screen for migrating SEO data from another plugin](https://plugpress.co/wp-content/uploads/2026/07/waggle-settings-import-scaled.png) 1. Open **Settings → Import**. The screen shows three numbered steps so you always know where you are. 2. **Choose your source** — Yoast, Rank Math, or All in One SEO. Waggle detects which plugins have data present. 3. **Press Preview.** This step **writes nothing**. You get a count of affected posts and a field-by-field list of what would be copied. 4. Read the preview. If it looks right, press **Migrate**. 5. Spot-check a handful of posts in the editor afterwards — open the **Waggle** panel and confirm the SEO Title and Meta Description came across. See [the Waggle panel in the editor](/docs/waggle-editor-sidebar/). ## Will the import overwrite my existing Waggle data? No. The importer skips any field that already has a value in Waggle. That single rule is what makes it safe to run more than once, and it means the order you do things in does not matter much — you can import first and edit after, or edit first and import after. The practical consequence: if you have already hand-written a title for your homepage and then import from Yoast, your hand-written title stays. If you genuinely want the old plugin's value instead, clear the Waggle field first, then re-run the import. ## When should I deactivate the old plugin? **After the preview looks right, and ideally right after you migrate.** Two SEO plugins running at once will both try to emit a title tag, a meta description, canonical tags and Open Graph tags, which produces duplicates in your page source. Waggle actively suppresses the most common competitors' front-end output when it detects them, but that is a safety net, not a plan. Deactivate the old plugin once you're happy. Your old plugin's data stays in the database after deactivation, so you can re-run the import later if you need to. Deleting the old plugin — as opposed to deactivating it — may remove that data, so keep it deactivated-but-installed until you're confident. ## What about redirects from my old plugin? Redirects are not part of the SEO-meta import. Waggle has its own redirect manager under **Redirects → Rules**, and it accepts **CSV import**, so exporting redirects from your old plugin and importing the CSV is usually the fastest path. See [fixing broken URLs with redirects and the 404 log](/docs/waggle-redirects-and-404s/). ## After the import: what to check 1. **Run the audit.** **Waggle → Dashboard → Run audit** gives you a score out of 100 and tells you what the migration didn't cover. See [running the site audit](/docs/waggle-running-the-site-audit/). 2. **Check SEO → Homepage.** Front-page SEO is stored differently by every plugin and is the most common thing to arrive empty. 3. **Check SEO → Verification.** Search Console and Bing verification tokens are not part of the import — paste them in again. 4. **Confirm your sitemap.** Visit `https://example.com/sitemap.xml` and make sure it lists real URLs. If you had a physical `sitemap.xml` file on disk from an older plugin, it will be served instead of Waggle's; the audit flags this specifically. ## FAQ ### Does the import change my live pages? Not in itself. It copies stored meta into Waggle's own fields. Your pages change only in the sense that Waggle then emits those values instead of your old plugin — which is the point of migrating. ### Can I import from more than one plugin? Yes, one at a time. Because the importer never overwrites a populated field, running Yoast then Rank Math fills gaps rather than fighting. Preview each run separately. ### What if the preview shows fewer posts than I expected? That usually means those posts had no SEO meta stored in the old plugin — many sites have titles set on only a fraction of their content. It can also mean the field is already populated in Waggle and is therefore being skipped. ### Is there a way to undo an import? There is no one-click undo. Preview is the safety mechanism, which is why it writes nothing and shows a per-field list. Take a database backup before migrating a large site, as you would with any bulk change. ### Do my Yoast readability or SEO scores come across? No, and they wouldn't mean the same thing if they did. Waggle scores pages on a different rubric aimed at AI answer engines — see [how Waggle scores content for AI answer engines](/docs/waggle-aeo-score/). ## Key sources - [Google Search Central — site moves and preserving rankings](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes) - [WordPress — managing plugins safely](https://wordpress.org/documentation/article/manage-plugins/) ## Related guides - [Getting started with Waggle](/docs/waggle-getting-started/) - [Running the site audit and fixing what it finds](/docs/waggle-running-the-site-audit/) - [Fixing broken URLs with redirects and the 404 log](/docs/waggle-redirects-and-404s/)