Loading tutorials…
Loading tutorials…
Yoast SEO powers SEO on 13M+ WordPress sites. The install itself takes five minutes — but doing it on a live site with a competing plugin, a caching layer, and a paid license is where most owners corrupt their meta data. This is the clean-install path.
Who this is forWordPress site owners installing Yoast SEO for the first time, replacing an existing plugin (RankMath, AIOSEO, SEOPress), or moving from Yoast free to Yoast Premium. Especially relevant if your site has been live for 2+ years and has accumulated SEO plugin history in the database.
What you'll need
Step 1
Take a database backup, then deactivate any other SEO plugin (RankMath, AIOSEO, SEOPress). Never run two SEO plugins at once.
Take a fresh database backup before doing anything. UpdraftPlus, BlogVault, or your host control panel (cPanel → Backup, WP Engine → Backups, Kinsta → Backups) all work. Verify the backup downloads successfully — a backup that lives only on the server you are about to break is not a backup.
WordPress Admin → Plugins → Installed Plugins. Scan for: RankMath, All in One SEO Pack, SEOPress, The SEO Framework, Squirrly SEO, Slim SEO, SmartCrawl. Any of these will conflict with Yoast.
Open the existing plugin and look for an export tool. RankMath → Status & Tools → Import & Export. AIOSEO → Tools → Import/Export. SEOPress → SEO → Tools. Export to a backup file and save it outside the WordPress install (Google Drive, Dropbox).
Now deactivate the competing plugin — DO NOT click Delete yet. Yoast will detect the previous plugin during setup and offer to migrate the meta data. You need it still in the database for the migration to work.
Step 2
WordPress Admin → Plugins → Add New → search "Yoast SEO" → Install Now → Activate. Always install the free plugin first, even if you bought Premium.
WordPress Admin → Plugins → Add New.
In the search field, type "Yoast SEO" (with the space). The first result should be "Yoast SEO" by Team Yoast — verify the author name and the 10M+ active installs count before clicking. Plugin-spoofing attacks exist.
Click "Install Now." Wait for the green checkmark — usually 5-15 seconds.
Click "Activate." Yoast adds a top-level "Yoast SEO" item to the WordPress admin sidebar.
Even if you bought Premium, install free first — Premium installs as a separate plugin that extends the free version. Order matters: free must be active for Premium to load correctly.
Step 3
Download the Premium ZIP from your Yoast account, upload via Plugins → Add New → Upload Plugin, activate, then enter your license key.
Log in to my.yoast.com → Downloads. Find Yoast SEO Premium → click "Download." You will get a ZIP file (wordpress-seo-premium-XX.X.zip).
WordPress Admin → Plugins → Add New → click "Upload Plugin" at the top.
Choose the ZIP file you just downloaded → Install Now → Activate Plugin.
You now have BOTH "Yoast SEO" and "Yoast SEO Premium" in Plugins → Installed Plugins. Both must stay active.
WordPress Admin → Yoast SEO → General → Premium. Paste your license key. Click "Activate." A green checkmark confirms activation — this enables the redirect manager, internal linking suggestions, and multiple focus keyphrases.
Step 4
Yoast SEO → Tools → Notifications. Resolve any red alerts before touching configuration. Conflicts cause silent meta corruption.
Open Yoast SEO → General → Dashboard. Scroll to "Problems." Any red items here block correct operation.
Most common red flag: "WordPress is set to discourage search engines from indexing this site." Fix: WordPress Admin → Settings → Reading → uncheck "Discourage search engines from indexing this site." This is the single most common reason a freshly-launched site stays out of Google for months.
Second most common: "Another SEO plugin is active." If you see this, return to step 1 and deactivate it — Yoast cannot run reliably alongside RankMath/AIOSEO/SEOPress.
Yoast SEO → Tools → Notifications. Yoast may show migration suggestions if it detected RankMath/AIOSEO data. We handle the import in the first-time configuration tutorial — for now just confirm the notification exists.
Step 5
Clear page cache, object cache, and CDN cache. Then View Source on a live post and confirm Yoast is writing the title/meta tags.
Clear every caching layer. WP Rocket → Settings → Clear Cache. LiteSpeed Cache → Toolbox → Purge All. W3 Total Cache → Performance → Dashboard → empty all caches. WP Engine: Cache → Purge All. Kinsta: Tools → Site Cache → Clear Cache. Cloudflare: Caching → Configuration → Purge Everything.
Open any published post in an incognito window. Right-click → View Page Source.
Search the source for the comment block "This site is optimized with the Yoast SEO plugin" — Yoast inserts this marker around the meta tags it writes. If you see it, Yoast is active and writing.
Search for a single <title> tag and a single <meta name="description"> tag. Two of either means the old plugin is still writing meta (purge caches again, or the old plugin is not fully deactivated).
If you see neither, a caching layer is still serving the pre-install HTML. Wait 5 minutes and re-purge.
Step 6
Yoast depends on the WordPress REST API for sitemap routes and on wp-cron for the indexable scheduler. Verify both work before configuring.
In a private window, visit yoursite.com/wp-json/. You should see a JSON response listing API routes. If you get a 404 or "REST API disabled," a security plugin (Wordfence Premium, iThemes Security) or a server rule is blocking it. Yoast sitemaps will 404 until this is fixed.
Visit yoursite.com/wp-json/yoast/v1/. You should see Yoast-specific routes. Empty response means Yoast is installed but not loading — usually a PHP version conflict (Yoast 23+ requires PHP 7.4+; check your host control panel).
Yoast SEO → Tools → Bulk editor. If you see "Yoast is rebuilding indexables," wp-cron is working. If the indexable counter is stuck, wp-cron is broken: many hosts disable WordPress cron in favor of a real system cron. Ask your host whether DISABLE_WP_CRON is true.
Indexable rebuilding can take 2-30 minutes on a small site, several hours on a 10K-post site. Let it finish before running the first-time configuration.
Step 7
Enable auto-updates for security patches. Document the version, license, and install date in your team wiki — this matters for future debugging.
WordPress Admin → Plugins → Installed Plugins. Find Yoast SEO. Click "Enable auto-updates" in the right column. Repeat for Yoast SEO Premium if installed.
Auto-updates apply minor releases (24.0 → 24.1) which are almost always safe. Major releases (24.x → 25.0) still require your review — Yoast emails account holders 14 days before a breaking release.
Write down: Yoast version installed, free vs Premium, license key location, install date, and which plugin (if any) it replaced. Add a row to your team wiki or a Notion page. Future-you debugging a rankings drop in 8 months will thank present-you.
Optional but recommended: install ManageWP, MainWP, or InfiniteWP if you manage 3+ WordPress sites. Centralizing plugin update management for Yoast across sites saves time and reduces drift between sites.
Common mistakes
Installing Yoast without backing up the database first
What goes wrong: Yoast registers new database tables (wp_yoast_indexable, wp_yoast_indexable_hierarchy) and migrates meta from the previous plugin. If anything fails mid-migration, you are recovering from whatever backup you have — which on shared hosting is often a 7-day-old nightly. Reverting can lose a week of meta edits, plus any blog posts written in between.
How to avoid: Take a manual database backup (UpdraftPlus, BlogVault, host control panel) within the 24 hours before installing. Verify the backup file downloaded to your local machine — not just sitting on the server.
Running Yoast and RankMath (or AIOSEO) simultaneously
What goes wrong: Both plugins write meta tags. Both ship XML sitemaps. Google picks one source arbitrarily and indexes mismatched content — older sitemap URLs typically win, locking in legacy URLs. Rankings drift 10-25% within 30 days while indexes diverge.
How to avoid: Deactivate the competing SEO plugin BEFORE activating Yoast. Export the old plugin meta data first as a backup. Verify Yoast is the single source via View Source on 5+ live pages before deleting the old plugin.
Deleting the old SEO plugin before Yoast import is verified
What goes wrong: Once you delete the old plugin, its meta data is wiped from the database. If you skipped the Yoast import flow (or if the import failed silently), all your manually-written titles and descriptions are gone. Every page falls back to template — and you may not notice for weeks.
How to avoid: Keep the old plugin installed (deactivated) for at least 7 days after Yoast goes live. Verify titles and descriptions on 10+ random posts match what you had before. Only then delete.
Skipping the 'Discourage search engines' checkbox in Settings → Reading
What goes wrong: Many sites are launched from staging where this checkbox was on. Yoast cannot override it. A perfectly-configured Yoast install on a discouraged site produces noindex meta on every page. Site stays out of Google for weeks while you debug other things.
How to avoid: WordPress Admin → Settings → Reading → uncheck "Discourage search engines from indexing this site." Save. Then request re-indexing in Google Search Console.
Installing Premium without first installing the free Yoast SEO plugin
What goes wrong: Yoast SEO Premium is an add-on that extends the free plugin. Without free installed, Premium loads but most features (redirect manager, internal linking, multiple focus keyphrases) silently fail. You paid $99/year for features that are not running.
How to avoid: Install Yoast SEO free FIRST from the WordPress repo. Then upload Yoast SEO Premium ZIP from my.yoast.com. Both stay active.
Ignoring the REST API check before configuring
What goes wrong: If the WordPress REST API is blocked (often by Wordfence Premium, iThemes Security, or a server-level mod_security rule), Yoast sitemaps will 404, the indexable rebuilder will hang, and the configuration wizard may fail with cryptic errors. You debug for hours before discovering the API is off.
How to avoid: Visit yoursite.com/wp-json/ in a private window before configuring Yoast. If you get 404, fix the API access first — usually a security plugin allowlist for /wp-json/yoast/* routes.
Recap
Done — what's next
How to configure Yoast SEO with the first-time configuration wizard
Read the next tutorial
Hand it off
The Yoast install itself is 5 minutes. The clean install on a live site with a competing plugin, a caching layer, and a Premium license is closer to an hour — and most of the risk lives in the migration step. A vetted technical SEO specialist on EverestX runs this install, verifies clean state, and ships a rollback plan in one focused session — typically $40-80 total at $14-16/hr.
See specialist rates
No — the free plugin handles 90% of sites. Premium ($99/year per site) adds the redirect manager, internal linking suggestions, multiple focus keyphrases, and 24/7 support. Buy Premium only if you change URLs frequently (e-com category restructures), publish a lot of editorial content, or want the support channel. Install free first either way.
Yes, and it is the best time to do it. With no existing meta data, there is no migration risk. Install Yoast immediately after WordPress core is up and before publishing the first post — this avoids ever needing to clean up meta from a competing plugin.
Yes. Current Yoast SEO releases require WordPress 6.4+ and PHP 7.4+. Installing on older versions either fails or installs a stale Yoast version that no longer receives security updates. Update WordPress core first (after a backup).
Three checks: (1) Plugins → Installed Plugins shows Yoast SEO with no "Activate" link (it is already active); (2) the WordPress admin sidebar has a top-level "Yoast SEO" item; (3) View Source on a live post shows the "<!-- This site is optimized with the Yoast SEO plugin -->" comment block. All three must be true.
Properly configured: no measurable impact on a healthy install (under 50ms front-end overhead). The first 24-72 hours after install are slower because Yoast rebuilds its indexables table — once that finishes, performance returns to baseline. Sites with 10K+ posts on shared hosting feel this more.
Yoast SEO
Yoast's first-time configuration wizard is six clicks long and quietly makes 30+ decisions about how your site appears in search. Most owners rush it and ship the wrong indexing defaults, wrong schema type, and wrong social profile links. This is the slow version.
Yoast SEO
Yoast fails in predictable patterns: plugin conflicts, REST API blocks, cache layers, theme schema duplication, license activation issues, and indexable corruption. This is the diagnostic playbook to find which one you have — without trial-and-error.
Yoast SEO
Yoast SEO powers 13M+ sites; RankMath has eaten 35% of the WordPress SEO market in 5 years. Both work. The right pick depends on your site age, your stack, and your appetite for migration risk. This is the framework — not a feature scorecard.
WordPress
Yoast is the default SEO plugin for 13M+ WordPress sites — but most installs ship with the wrong sitemap settings, broken breadcrumbs, and schema that contradicts your theme. This walks through the install + the configuration the wizard skips.
Yoast SEO
Most WordPress site owners can install and configure Yoast themselves. But some scenarios — migrations, schema deep-debugging, 5+ year old sites with technical debt — burn more DIY time than the specialist would cost. This is the honest signals list.