Yoast & Rank Math Setup for Converted WordPress Themes

Set up Yoast SEO or Rank Math on WPConvert-converted themes — plugin hooks, seeding, and analyser content.

Stop Getting Red SEO Scores on Converted AI Sites — Your Real Content Reaches the Analyser.

You converted your AI-built site to WordPress, installed Yoast SEO or Rank Math, and opened a page expecting green lights. Instead:

• The SEO analysis shows red — "Focus keyphrase not set"
• The readability score is grey or wrong
• The meta description is blank even though your live page has copy
• Word counts look like the page is empty

That's not because your site has bad SEO. It's because most converted themes store almost nothing in post_content. The real HTML lives in PHP templates (front-page.php, page-*.php), not in the WordPress editor body field. Yoast and Rank Math analyse post_content by default — so they think every page is a stub.

WPConvert fixes that — built into every theme, on every plan.

Your converted theme ships captured SEO data, outputs meta tags and JSON-LD without a plugin, and — when you install Yoast SEO or Rank Math — connects to their official hooks so analysers see your real page text, word counts reflect actual content, and SEO snippets are pre-filled the first time you open each page in the editor.

Summary (TL;DR): Every WPConvert theme (including Starter) bundles seo.json and seo-content.json and outputs page titles, meta descriptions, Open Graph tags, canonical URLs, and JSON-LD out of the box. Install Yoast SEO or Rank Math from Plugins → Add New (there is no separate WPConvert SEO plugin to upload). Open each page under Pages → Edit once — that triggers one-time seeding of the SEO title, meta description, focus keyphrase, and Cornerstone/Pillar flag for the home page. The theme stands down its own meta tags when a plugin is active (no duplicates) and feeds the plugin's content analyser your real rendered page content via official filters — so scores reflect what visitors actually see.

Why SEO Plugins Break on Converted AI Sites

Most AI-to-WordPress conversions produce template-driven themes:

• Page markup is rendered by PHP files, not stored in the post body
• The WordPress editor shows a short placeholder — by design
• Nav labels in wp-admin (e.g. "Home", "Plan") are not the same as the source site's <title> tag
• Headings, paragraphs, and CTAs live in front-page.php and route templates

When you install Yoast SEO or Rank Math on that kind of theme:

The front-end site can look perfect. The admin SEO panel still rates it red.

You'll see advice online to "mirror the_content()" or paste HTML into the post body. That fights how WPConvert themes are structured and creates duplicate content problems. WPConvert takes a cleaner path: capture semantic content at conversion time, then hand it to Yoast and Rank Math through their supported extension points.

What WPConvert Ships Out of the Box (No Plugin Required)

Before you install anything, every converted theme already includes:

1. Captured SEO metadata

During conversion, WPConvert reads each route's <title>, meta tags, headings, and visible copy. Two JSON files ship inside your theme:

• assets/data/seo.json — page titles and descriptions captured from the source
• assets/data/seo-content.json — cleaned, semantic HTML for content analysers (headings, paragraphs, lists, links — site chrome stripped)

2. Front-end SEO output

The theme emits on the live site:

• Page titles and meta descriptions (when captured from the source)
• Open Graph and Twitter Card tags
• Canonical URLs
• JSON-LD structured data (Organization, WebSite, WebPage, and more where applicable)

This works on all plans — Starter included. You don't need Yoast or Rank Math for basic SEO tags on the public site.

3. Sensible fallbacks for AI-built sources

Many AI-generated sites ship a <title> but no <meta name="description">. WPConvert handles that:

• If the source had no meta description, the theme derives one from the page's first substantial paragraph (~155 characters) and can seed it into Yoast or Rank Math
• If a page has no <h1> (common on hero-led designs), the suggested focus keyphrase falls back to the first heading (h2, h3, …)
• Hero sections wrapped in semantic <header> tags are preserved — only masthead navigation headers are stripped during extraction

What Happens When You Install Yoast SEO or Rank Math

WPConvert does not ship a separate SEO plugin zip. Compatibility is built into the theme's functions.php. When Yoast or Rank Math is active:

1. No duplicate meta tags

The theme's own title and description emitters stand down so the SEO plugin takes over. You won't get doubled <title> tags or conflicting Open Graph output.

2. Content analysers see real page text

WPConvert registers on Yoast's wpseo_pre_analysis_post_content filter and Rank Math's rank_math/researcher/post_content filter. When you run an SEO or readability analysis in the editor, the plugin receives the captured semantic content from seo-content.json — not the empty placeholder in post_content.

That means:

• Readability checks reflect your actual prose
• Keyphrase checks can match against real headings and paragraphs
• Internal link suggestions work against meaningful text

For Yoast's standalone word-count surfaces (cornerstone analysis, the "X words" indicator), WPConvert also hooks wpseo_post_content_word_count with the captured word count from seo-content.json.

3. SEO snippets pre-filled on first edit

When you open a page in the WordPress editor (Pages → Edit), the theme seeds plugin postmeta once per field — and never overwrites values you've already set:

Important: Seeding runs when you open the page in the editor, not the moment you activate the theme. A blank focus keyphrase and a red SEO score on a brand-new page in the Pages list are normal until you've opened that page once.

The theme never changes post_title, slugs, or nav labels — only plugin SEO fields are seeded.

4. Sitemaps and breadcrumbs stay with the plugin

WPConvert leaves XML sitemaps, breadcrumb markup, and advanced schema extensions to Yoast or Rank Math. Your converted pages are real WordPress pages with proper URLs, so plugin sitemaps and breadcrumbs work as expected.

How to Set Up Yoast SEO or Rank Math on a WPConvert Theme

Step 1 — Install and activate your theme

Upload the theme zip under Appearance → Themes → Add New → Upload Theme, then Activate. WPConvert creates pages and menus automatically.

Step 2 — Install Yoast SEO or Rank Math

Go to Plugins → Add New, search for Yoast SEO or Rank Math, install, and activate. Run the plugin's setup wizard as you normally would.

There is no wpconvert-seo.zip to upload. Compatibility is already in the theme.

Step 3 — Open each page once in the editor

Go to Pages → All Pages and open each page (Edit). That first edit-screen visit triggers the one-time seeding of SEO title, meta description, and focus keyphrase.

Check the Yoast or Rank Math panel in the editor — you should see:

• The SEO title populated from your source site's <title> (e.g. "Tahiti Time | Luxury French Polynesia Travel Planning")
• A meta description from the source or derived from the first paragraph
• A suggested focus keyphrase from the page's main heading
• The home page flagged as Cornerstone (Yoast) or Pillar Content (Rank Math) after theme activation

Review and adjust anything in the snippet editor. Seeding is a starting point, not a lock-in.

Step 4 — Run the analyser

With the page open, scroll to the SEO and readability analysis sections. Scores should now reflect your actual page content — not an empty post body.

Your theme zip also includes a README.txt with this SEO section, and the WPConvert dashboard Getting Started modal walks through the same steps after download.

Example: AI Travel Site → Yoast-Ready WordPress

1. Convert a Lovable, Cursor, or Claude-built travel site with WPConvert.
2. Download the theme zip and install it in WordPress.
3. Install Yoast SEO from the plugin directory and complete its wizard.
4. Open the Home page in the editor. Yoast pre-fills the SEO title from the captured source <title>, seeds a meta description from the hero intro paragraph, and sets a focus keyphrase from the page heading.
5. Open Plan, Privacy, and other pages the same way — each route's captured data seeds independently.
6. View the live site — meta tags and JSON-LD were already outputting correctly before you installed Yoast. Yoast now manages snippets, sitemaps, and advanced analysis on top.

Your AI-built site is SEO-plugin-ready without pasting HTML into post bodies or writing custom the_content() mirrors.

Generic Conversion vs WPConvert SEO Integration

Who Should Use This

• Agencies delivering AI-built client sites who standardise on Yoast or Rank Math
• Freelancers converting Lovable, v0, Cursor, or Claude exports who don't want to hand-fix every SEO field
• Site owners who rely on Yoast's readability checks and focus keyphrase scoring
• Developers who know the post_content placeholder pattern and want plugin hooks handled correctly
• Anyone searching for "convert AI website to WordPress Yoast SEO" or "Rank Math empty content score" fixes