Skip to content

[00] Subset SEO, User guide

Import from another SEO plugin

Bring your titles, descriptions, social fields, robots settings and templates across from Yoast SEO, Rank Math, All in One SEO or SEOPress.

SEO imports from Yoast SEO, Rank Math, All in One SEO (version 4) and SEOPress. It reads the other plugin’s data straight from the database, so that plugin doesn’t need to be active, and it never changes or deletes that data. You can import again or switch back at any time.

Run an import

  1. Go to Subset → SEO → Tools.
  2. Under Import from another SEO plugin, choose the plugin. Only plugins with data on your site are offered.
  3. Click Preview. Nothing is written, and you get a report of exactly what an import would do.
  4. If the report looks right, click Import.

A large site’s import keeps going in batches until it’s done. If you close the page or a request times out, the next visit picks up from the last saved batch.

When you’re happy, deactivate the old plugin. Until you do, Subset SEO keeps its own tags, schema and sitemaps off the front end, and Site Health tells you why.

What comes across

For posts and terms:

  • SEO titles and meta descriptions
  • Canonical URLs
  • Robots settings (noindex, nofollow, noarchive, nosnippet, noimageindex, notranslate)
  • Open Graph and X titles, descriptions and images
  • Focus keyphrases (posts only)
  • Primary categories and other primary terms
  • Breadcrumb titles
  • The schema type, from Yoast SEO and All in One SEO

From Yoast SEO and Rank Math, author titles, descriptions and noindex settings come across too.

Site-wide, the import brings the title separator, title and description templates, which pages show in search results, author and date archive switches, attachment page handling, the default article type, who the site represents, social profiles, the default share image, the X card and the breadcrumb settings.

Template variables are translated to Subset SEO’s %%name%% variables, and custom fields become %%cf_<key>%%. A variable with no equivalent is left out of the template and listed in the report.

What wins when values clash

  • A value SEO already has is kept, unless you tick Replace values Subset SEO already has.
  • Running the same import twice changes nothing the second time.
  • Every value is cleaned the way the editor cleans it. A canonical URL that isn’t http or https, a primary term that no longer exists or an image outside the media library is left out.
  • A template that matches Subset SEO’s built-in one isn’t stored, so you keep getting improvements to the built-in template.

Read the report

The report counts the posts, terms and authors found, imported, unchanged and no longer existing. Under Left out, it lists everything it skipped and why: extra focus keyphrases, variables with no equivalent, images outside the media library, per-post schema and unsupported card types.

Redirects

Redirects aren’t imported here. The report counts them, and Subset Redirects has its own importer for redirects from Yoast SEO Premium and Rank Math.

Import from the command line

wp subset seo import                       # list the plugins with data on this site
wp subset seo import yoast --dry-run       # preview
wp subset seo import yoast                 # import
wp subset seo import rank-math --overwrite # replace values SEO already has

The sources are yoast, rank-math, aioseo and seopress.