Loading tutorials…
Loading tutorials…
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.
Who this is forWordPress site owners who just installed Yoast SEO (free or Premium) and are about to run — or recently ran — the first-time configuration wizard. Especially relevant if you skipped the wizard, ran it too fast, or your business type has changed since you ran it.
What you'll need
Step 1
Yoast SEO → General → First-time Configuration. If you already ran the wizard, the same screen lets you re-run any step independently.
WordPress Admin → Yoast SEO → General. The top tabs are Dashboard, First-time Configuration, Integrations, Webmaster Tools.
Click "First-time Configuration." You see a checklist of 5 sections: SEO data optimization, Site representation, Social profiles, Personal preferences, Sign in to Google.
If this is a brand new install, all sections are blue (not started). If you already ran the wizard, completed sections are green — you can click any one to re-run it.
DO NOT click 'Start configuration' yet. Read the next steps and have your inputs (logo, social URLs, GSC access) ready before you start — partial wizard runs can leave inconsistent state.
Step 2
Click "Start SEO data optimization." Yoast rebuilds the wp_yoast_indexable table. Do not navigate away until it shows 100%.
This step is non-interactive — Yoast scans every post, page, taxonomy term, and user and writes them into the indexables table. The indexables table is what powers the sitemap, breadcrumbs, and schema.
On a 100-post site this takes 30 seconds. On a 10K-post site it can take 30 minutes. The progress bar moves in chunks of ~50 indexables at a time.
DO NOT close the browser tab or navigate away. If you do, the process pauses and re-runs from the last completed chunk when you return — but it can leave the table in inconsistent state until completion.
When you see "Success! Your SEO data is optimized" with a green checkmark, the indexables table is ready. Click "Continue."
Step 3
Choose Organization for almost every business site. Person only for personal blogs and solo creators. Upload the right logo.
Organization vs Person: This decides which JSON-LD schema Yoast writes site-wide. Organization is right for 95% of business sites — agencies, e-commerce, SaaS, professional services. Person is right for personal blogs (yourname.com), solo creator sites, and freelancer portfolios.
Once chosen, this is hard to change without breaking Google Knowledge Panel association. Be deliberate.
Organization name: Enter the EXACT legal name that matches your Google Business Profile, About page, and footer copyright. Inconsistency confuses entity recognition. "Acme, Inc." and "Acme Inc" are different strings to Google.
Organization logo: Upload at minimum 600×60px. Yoast recommends 696×696 (square) for maximum compatibility with Google rich results. PNG with transparency works best — JPEG with a white background is fine if the logo has no fine detail.
Person: pick the WordPress user account that represents you. Upload an avatar (square, 696×696 or larger). The chosen user must be an Author or higher.
Step 4
Add the FULL URL of every active social profile. These populate sameAs in the Organization/Person schema and feed entity recognition.
Yoast supports: Facebook page URL, X/Twitter handle (just the @handle), Instagram URL, LinkedIn URL, YouTube channel URL, Pinterest URL, TikTok URL, Wikipedia URL.
Use the FULL URL, not the handle (except X/Twitter where only the handle is needed). facebook.com/yourbrand — not facebook.com or just "yourbrand."
Only include profiles that are: (a) active in the last 90 days, (b) clearly yours, (c) match your business name. Listing a dormant Pinterest account weakens the signal.
If you have a Wikipedia entry, add it — Wikipedia is one of the strongest entity signals you can give Google. If you do not have one, do not invent it.
After save, validate: visit yoursite.com homepage → View Source → search for sameAs. You should see a JSON array containing every URL you entered.
Step 5
Decide which content types appear in Google. For most sites: Posts YES, Pages YES, Categories YES, Tags NO, Authors NO, Dates NO.
This step is now part of the wizard in current Yoast versions but the actual toggles live under Yoast SEO → Settings → Content Types and Settings → Categories & Tags. Open both in parallel.
Posts: YES — index. Almost no site should hide its blog posts.
Pages: YES — index. About, Services, Contact, landing pages all need to be indexable.
Categories: YES if categories serve a content-discovery purpose (blog category pages link to multiple useful posts). NO if categories are thin or duplicate other archives.
Tags: NO for 90% of sites. Tag archives are usually thin — 1-3 posts per tag — and create duplicate-content traps. Only YES if you have curated, useful tag taxonomy with 10+ posts per tag and unique value beyond the post list.
Author archives: NO if you are a single-author site (the author archive is identical to the blog archive — duplicate). YES if you are a multi-author publication with meaningful author landing pages.
Date archives: NO almost always. /2024/05/ archives are duplicate content and dilute crawl budget.
Media (attachment URLs): NO and redirect to the parent post. Yoast SEO → Settings → Media Pages → "Redirect media attachment URLs to the attachment itself" toggle ON. This kills hundreds of thin /?attachment_id= URLs.
Step 6
Skip the Yoast newsletter unless you want it. Sign in to Google Search Console for in-dashboard SEO data.
Personal preferences asks whether to share usage data with Yoast and subscribe to the newsletter. No SEO impact either way. Pick what you want.
Sign in to Google: Opens an OAuth flow that links your GSC account to Yoast. Once linked, the Yoast dashboard widget shows your top-performing queries pulled from GSC.
Useful but not required. You can skip this step in the wizard and link later via Yoast SEO → Integrations → Google Search Console.
If you do link: choose the property that matches your full canonical domain. Mismatching www vs apex, or http vs https, will load zero data — Yoast does not autocorrect.
Step 7
Open a published post in an incognito window. View Source. Confirm meta tags, JSON-LD schema, and breadcrumb data reflect your wizard answers.
Pick any published post or page. Open in a private window. Right-click → View Page Source.
Find the <title> tag. It should read like "Post Title | Brand Name" — matching the template you set (or Yoast default of %%title%% %%sep%% %%sitename%%).
Find <meta name="description">. Should contain your post excerpt or manually-written meta description. Empty here means a template fell back to nothing.
Find the JSON-LD <script type="application/ld+json">. You should see an @graph array containing: Organization (or Person) with your name and sameAs URLs, WebSite with your sitename, WebPage for the current URL, and Article for blog posts.
Open Google Rich Results Test (search.google.com/test/rich-results). Paste the URL. Verify "Detected items" includes Organization (or Person) and the page-type schema. No errors should show.
If anything is missing or wrong, return to the wizard step that controls it and re-save.
Common mistakes
Choosing Organization when you should have chosen Person (or vice versa)
What goes wrong: Wrong schema type sitewide. Google Knowledge Panel will not associate your content with your real entity. Branded search results miss the rich-result treatment. Hard to reverse — fixing it requires the wizard re-run plus 4-8 weeks for Google to re-crawl and re-cache.
How to avoid: Re-run the Site representation step in the wizard. Update on a Sunday so the change goes out before Monday traffic. Request re-indexing of your homepage in GSC.
Saying YES to indexing tags, author archives, and date archives
What goes wrong: A site with 200 posts and 5 tags per post creates 200+ thin tag-archive URLs of mostly-duplicate content. Plus author archive duplicates for single-author sites. Plus date archives. Google sees quality collapse and overall rankings drift down 15-30% within 90 days.
How to avoid: Yoast SEO → Settings → Categories & Tags → Tags → "Show Tags in search results?" → NO. Repeat for Author archives and Date archives. Re-crawl via GSC.
Uploading a low-resolution logo (under 600×60px)
What goes wrong: Google rejects logos below 600×60px for SERP rich results. Your branded queries miss the logo display. Yoast does not warn about this — it just silently fails Google validation.
How to avoid: Upload a logo at 696×696px square minimum, PNG with transparency. Re-test in Rich Results Test → Organization → logo field should validate green.
Listing dormant or wrong-case social URLs
What goes wrong: sameAs schema lists URLs Google cannot verify or that 404. Entity recognition weakens. Bing especially down-weights sites with broken sameAs entries.
How to avoid: Audit every URL in Yoast SEO → Settings → Site representation. Open each in a private window. Remove dormant ones (no activity in 90 days). Fix casing to match the canonical URL on the social network.
Skipping the SEO data optimization step
What goes wrong: Indexables table is incomplete. Sitemap is missing pages. Breadcrumbs render incorrectly. Schema falls back to defaults. Symptoms look random — pages dropping in and out of the sitemap with no obvious pattern.
How to avoid: Yoast SEO → Tools → Optimize SEO data. Click "Start SEO data optimization." Wait for 100% completion before closing the tab.
Linking the wrong GSC property
What goes wrong: Yoast dashboard shows zero query data because it is pulling from a GSC property that does not match the live domain. You think the integration is broken when it is just mismatched.
How to avoid: Yoast SEO → Integrations → Google Search Console → reconnect. Carefully pick the property matching your canonical domain (https://www.yourdomain.com, not http or apex).
Recap
Done — what's next
How to install the Yoast SEO plugin on WordPress
Read the next tutorial
Hand it off
The first-time configuration wizard is the single most consequential 90 minutes in your SEO setup. A vetted technical SEO specialist makes the right indexing calls based on your site history, configures sitewide schema once, and validates with Rich Results Test — typically $30-90 total at $14-16/hr. Worth it if your site has 3+ years of history or you are unsure about tag/archive decisions.
See specialist rates
Only if your business situation has changed (rebrand, legal name change, new social channels, switched from solo blog to multi-author publication). Otherwise leave it alone — the wizard re-run regenerates indexables and can cause a brief crawl-budget spike while Google re-checks everything.
Yes — Yoast SEO → Settings → Site representation lets you change it at any time. But every page across your site re-renders with new JSON-LD schema, and Google takes 2-6 weeks to recrawl and update its Knowledge Graph. Plan the switch deliberately, ideally during a low-traffic window.
Absolutely yes — a Wikipedia URL is one of the strongest entity signals possible. Yoast SEO → Settings → Site representation → Other profiles → paste the Wikipedia article URL. If you do not have a Wikipedia article, do not create a low-quality one just for SEO; it will be deleted by editors.
Most common cause: the GSC property linked does not match the canonical live URL. If your site serves at https://www.yourdomain.com but you linked a https://yourdomain.com property, Yoast sees the wrong dataset and shows nothing. Reconnect and pick the exact matching property.
Partially. Yoast wizard sets one Organization schema sitewide. Multilingual sites should manually set per-language hreflang via the WPML/Polylang integration after the wizard finishes. The wizard does not configure hreflang — that is a separate step.
Yoast SEO
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.
Yoast SEO
Title tags and meta descriptions drive your CTR in the SERP. Yoast templates use variables (%%title%%, %%sitename%%, %%excerpt%%) to set defaults at scale — but defaults are only as good as the patterns you choose. This is the per-content-type setup that works for most sites.
Yoast SEO
Yoast outputs JSON-LD schema by default — Organization, WebSite, BreadcrumbList, Article, WebPage. But the defaults assume a one-author blog. Multi-author sites, e-commerce, local businesses, and publishers need configuration to get the schema Google actually rewards with rich results.
Google Search Console
WordPress gives you four ways to verify GSC. Three of them break when you change theme or SEO plugin. Here's the path that survives migrations — and what to do if you've already locked yourself into a fragile one.
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.