Table of contents
The green light is Yoast's most famous feature and its most misunderstood. Here's what the focus keyphrase really is, how to choose one, and how to read the analysis like an editor instead of a slot machine. Shot on Yoast under WordPress 7.0, August 2026.
- The focus keyphrase = the search phrase this post targets. Yoast checks your draft against it.
- Set it in the Yoast sidebar; the SEO analysis lights update as you write.
- Fix red lights that are real (keyphrase absent, no meta description).
- All-green is not the goal — readable, useful content that ranks is.
Setting the keyphrase
Open a post, click the Yoast icon (top right) to open the sidebar, and type your phrase into Focus keyphrase. The SEO analysis and Readability analysis sections update live:
Choose the phrase a human would search — specific beats broad. "wordpress tutorial" is a war zone; "wordpress tutorial for real estate agents" is a winnable page.
Reading the lights like an editor
Expand SEO analysis for the itemized checks. Triage them in three buckets:
- Fix now — keyphrase missing from the title, first paragraph, or the whole text; no meta description; text too short for the topic. These are real signals.
- Fix if natural — keyphrase in a subheading, image alt text, slug. Do them where they read naturally; skip where they'd be forced.
- Ignore freely — density complaints on long pieces, exact-match demands that fight your grammar. Write for the reader; Google handles variants fine.
Readability's advice (shorter sentences, more subheadings) is genuinely good for web writing — treat it as a friendly copyeditor, same rules.
One phrase per post
If a post wants two unrelated keyphrases, split it into two posts and link them. Free Yoast enforces this helpfully by allowing one phrase; the "related keyphrase" upsell is rarely the answer — more focused pages are.
We've reviewed sites with perfect green dots on every post and no traffic — and messy orange posts that dominate their niche. The analysis checks mechanics, not merit. Get the mechanics clean quickly, then spend your time on the content itself.
Leave a comment