Loading tutorials…
Loading tutorials…
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.
Who this is forWordPress site owners who want technical SEO basics handled correctly the first time. Especially relevant if you are migrating from another SEO plugin (All in One SEO, RankMath, SEOPress) — bad migrations cause weeks of indexing problems.
What you'll need
Step 1
Two SEO plugins active at once write competing meta tags, ship two XML sitemaps, and confuse Google. Always remove the old one before installing Yoast.
WordPress Admin → Plugins → Installed Plugins. Scan for: RankMath, All in One SEO Pack, SEOPress, The SEO Framework, Squirrly SEO, or Slim SEO.
If you find one, click "Deactivate" — but DO NOT click "Delete" yet. You may need to roll back, and some plugins offer a one-click meta export tool you should run first.
Open the existing plugin and look for "Tools → Import/Export." Export your meta data as a backup file. RankMath, AIOSEO, and SEOPress all support this. Save the file outside the WordPress install (Dropbox, Google Drive, local desktop).
Once exported, deactivate. Yoast will detect the previous plugin during install and offer to import — keep the backup as a safety net.
Step 2
WordPress Admin → Plugins → Add New → search "Yoast SEO" → Install Now → Activate. Free version is enough for 90% of sites.
WordPress Admin → Plugins → Add New.
In the search field, type "Yoast SEO." The first result should be "Yoast SEO" by Team Yoast (10M+ active installs — verify before installing).
Click "Install Now." Wait for the green checkmark.
Click "Activate." Yoast adds a new top-level menu item to the admin sidebar called "Yoast SEO."
Yoast PRO is a paid upgrade ($99/yr for one site) that adds redirect manager, multiple focus keyphrases, and internal linking suggestions. Skip it until the free version is fully working and you have specific pain points it solves.
Step 3
Yoast SEO → General → First-time Configuration. Walk through site representation, social profiles, and indexing preferences carefully — these decisions are global.
Open Yoast SEO → General → First-time Configuration. Click "Start Configuration."
Step 1 — Site representation: Choose Organization or Person. For 95% of business sites this is Organization. Enter the legal organization name (the one matching your About page and Google Business Profile) and upload your logo at 600×60px or larger.
Step 2 — Social profiles: Add full URLs for every active profile (Facebook, X, Instagram, LinkedIn, YouTube). These populate sameAs entries in the Organization schema — used by Google for entity recognition.
Step 3 — Indexing preferences: This is the most important step. Tell Yoast which content types should be indexed: Posts (Yes), Pages (Yes), Categories (usually Yes), Tags (usually NO — see common mistakes), Author archives (NO if you are a single-author site — they create duplicate-content traps), Date archives (NO almost always).
Step 4 — Personal preferences: Whether to share usage data with Yoast. No SEO impact either way.
Step 5 — Sign in to Google Search Console: optional but useful for the Yoast SEO insights panel. You can do this later from SEO → General → Webmaster Tools.
Click "Save and close."
Step 4
Yoast generates an XML sitemap index at yoursite.com/sitemap_index.xml. Verify it loads, then submit to Google Search Console.
In a fresh browser tab, visit yoursite.com/sitemap_index.xml. You should see an index file linking to sub-sitemaps (post-sitemap.xml, page-sitemap.xml, etc).
If you get a 404, go to Yoast SEO → Settings → APIs → REST API and confirm it is enabled. Some security plugins (Wordfence Premium, iThemes) block sitemap routes by default.
Open each sub-sitemap and spot-check — every URL should be a page you actually want in the index. If you see category archives you marked NOINDEX, the cache is stale: SEO → Tools → File editor (or flush via Settings → Reading → Save twice) and revisit.
Open Google Search Console → Sitemaps. Paste sitemap_index.xml as the path. Click Submit.
Expect Google to process the sitemap within 24-72 hours. The "Discovered URLs" count should match your sub-sitemap totals roughly. Mismatch by more than 20% usually means a robots.txt block or canonical-tag issue.
Step 5
Breadcrumbs improve UX and add BreadcrumbList schema. Block themes (Twenty Twenty-Five) handle this in the Site Editor; classic themes need a code snippet.
Yoast SEO → Settings → Advanced → Breadcrumbs. Toggle "Enable breadcrumbs for your theme."
If you are on a block theme (Twenty Twenty-Five, Twenty Twenty-Four, or any FSE theme): Appearance → Editor → Patterns → search for "breadcrumb." Insert the Yoast Breadcrumbs block into your single post and single page templates.
If you are on a classic theme (Astra, GeneratePress, OceanWP, custom): you need to paste the breadcrumb snippet into your theme. Appearance → Theme File Editor → single.php (and page.php). Paste this above the post title: <?php if ( function_exists("yoast_breadcrumb") ) { yoast_breadcrumb( "<p id='breadcrumbs'>", "</p>" ); } ?>
Save the file. Visit any post on your live site. The breadcrumb trail should appear above the title.
Test the schema: paste the post URL into Google Rich Results Test (search.google.com/test/rich-results). You should see "Breadcrumbs" detected with no errors.
Step 6
Yoast SEO → Settings → Content Types. Set the title and meta description templates for Posts, Pages, and any custom post types.
Yoast SEO → Settings → Content Types → Posts. Find "SEO title" — set the template to: %%title%% %%page%% %%sep%% %%sitename%%
Set "Meta description" template to: %%excerpt%% — this falls back to the post excerpt if you forgot to write a manual meta description, which beats Google auto-generating from body copy.
Repeat for Pages, and any custom post types (Products if WooCommerce, Listings, Services, etc).
Open Yoast SEO → Settings → Search Appearance → Categories & Tags. Set the same kinds of templates. Be deliberate about whether category archives are indexed — they should add unique value beyond a list of post titles.
Audit 5-10 published posts. In the post editor, scroll to the Yoast SEO sidebar. The SEO title preview should match the template you set. If it does not, the per-post override field is filled in — clear it to inherit the template.
Step 7
Within 7-14 days of install, GSC should show clean indexing, working sitemap, and rich results. Watch for "indexed, though blocked by robots.txt" warnings.
Open GSC → Indexing → Sitemaps. Confirm sitemap_index.xml is "Success" status.
Open GSC → Indexing → Pages. Look at "Not indexed" reasons. "Excluded by noindex tag" is fine for tag/author archives you intentionally noindexed. "Discovered — currently not indexed" usually means thin content, not a Yoast issue.
Open GSC → Enhancements → Breadcrumbs. You should see a Valid count growing over the next 14 days as Google recrawls.
Open GSC → Enhancements → Organization or Sitelinks searchbox if you set those up. Verify no errors.
If you see "Indexed, though blocked by robots.txt" — Yoast did not cause this. Check robots.txt directly at yoursite.com/robots.txt and remove conflicting Disallow rules.
Common mistakes
Running Yoast alongside another SEO plugin
What goes wrong: Two plugins write two sets of title/meta tags. Two XML sitemaps get submitted. Google chooses arbitrarily and indexes the wrong one — typically the older sitemap, locking in legacy URLs you have already changed.
How to avoid: Deactivate the old SEO plugin BEFORE installing Yoast. Export meta data first as a backup. Delete the old plugin only after verifying live title tags via View Source.
Indexing tag and date archives
What goes wrong: A site with 200 posts and 5 tags per post creates 200+ tag-archive URLs of mostly-duplicate content. Google sees a quality signal collapse and overall rankings drift down 15-30% within 90 days.
How to avoid: Yoast SEO → Settings → Search Appearance → Taxonomies. Set Tag archives and Date archives to "No, show search results in search engines." Re-crawl via GSC.
Not setting the Organization or Person schema
What goes wrong: No Organization schema means no knowledge-panel eligibility, no logo in SERP results for branded queries, and no sameAs social profile linking. Brand SEO suffers silently.
How to avoid: Yoast SEO → Settings → Site representation. Choose Organization (or Person), upload logo, add legal name, add all social profiles. Verify in Rich Results Test.
Breadcrumbs enabled in Yoast but never rendered on the page
What goes wrong: Schema fires but no visual breadcrumbs appear because no template includes the Yoast Breadcrumb block or function call. Users get no navigation aid; SERP breadcrumbs may not show.
How to avoid: Block theme: insert Yoast Breadcrumbs block in Site Editor → Templates → Single. Classic theme: paste the yoast_breadcrumb() PHP into single.php and page.php.
Leaving the default Yoast Discouraged Indexing checkbox on
What goes wrong: WordPress has a Settings → Reading → 'Discourage search engines from indexing this site' checkbox, often left enabled from a dev/staging migration. Yoast does not override it. Entire site stays out of Google for weeks while you debug.
How to avoid: WordPress Admin → Settings → Reading → uncheck "Discourage search engines from indexing this site." Save. Re-request indexing in GSC.
Treating the Yoast traffic-light score as the goal
What goes wrong: Owners chase green dots on every post — stuffing focus keyphrases unnaturally, padding word counts, adding internal links to weak pages. Reads worse and ranks worse.
How to avoid: Use Yoast as a checklist, not a scoring system. Green is helpful directional feedback; it is not a ranking signal. Write for the reader first.
Recap
Done — what's next
How to install RankMath SEO on WordPress (and how it compares to Yoast)
Read the next tutorial
Hand it off
Yoast is a 2-3 hour install if everything goes right. It is a 2-3 week debug if you are migrating from another plugin or your site is older than 5 years. A vetted WordPress SEO specialist on EverestX runs the migration, configures the wizard, and verifies clean state in one afternoon — typically $80-200 total at $14-16/hr.
See specialist rates
Free covers 90% of sites: title tags, meta descriptions, XML sitemap, breadcrumbs, schema, and on-page analysis. Premium ($99/yr per site) adds the redirect manager, multiple focus keyphrases per post, internal-linking suggestions, and Zapier integration. Worth it if you redirect URLs frequently (e-com category restructures) or run a content-heavy editorial team.
Yes — Yoast detects the previous plugin on activation and offers a one-click meta import. It pulls over title tags, meta descriptions, focus keyphrases, and NOINDEX flags. Always export a backup from the old plugin first in case the import is partial.
Three causes in priority order: (1) a caching plugin (WP Rocket, W3 Total Cache) is serving an old version — purge cache; (2) the theme is hardcoding <title> tags in header.php and overriding Yoast — find and remove; (3) another plugin (often a 'must-use' plugin from a host) is writing meta. Check the page source for duplicate <title> tags.
For most sites, no. Yoast outputs Organization, WebSite, BreadcrumbList, and Article schema natively. Add a separate plugin (Schema Pro, RankMath standalone schema modules) only if you need specific types Yoast does not cover well — FAQ, HowTo, Product, Review, LocalBusiness with multiple locations.
Properly configured: no measurable impact (under 50ms on a healthy install). Common cause of slowdown is the cornerstone-content / link-counter feature running heavy queries on large sites. If you have 5,000+ posts and feel a slowdown, Yoast SEO → Settings → Tools → Bulk editor → disable the link counter.
Optional. The Yoast → Zapier hook publishes new posts to a Zap trigger that can fan out to social. Useful for editorial teams, overkill for solo sites. Buffer or a dedicated social-media tool usually does this better.
WordPress
RankMath has eaten 35% of the WordPress SEO market in 5 years for one reason: it ships with features Yoast charges Premium for, free. This is the full setup — and the honest comparison so you pick the right plugin once.
WordPress
Installing Yoast or RankMath is step two. Step one is making sure WordPress itself is configured for SEO — permalinks, indexable content rules, taxonomy hygiene. Skip this and the SEO plugin is putting lipstick on a leak.
WordPress
WordPress is the easiest CMS to start with and the easiest to make a mess of by month 18. This is the honest framework for when DIY becomes the bottleneck and a specialist pays for themselves.