Yoast's keyphrase in introduction check, explained
Yoast SEO's Keyphrase in introduction check reads only the first paragraph of your post. It goes green when every content word of your focus keyphrase (or of a synonym you added) appears inside one sentence of that paragraph, orange when the words are all there but spread across different sentences, and red when they are missing.
It is a nudge to tell readers what the page is about straight away. Google does not require your keyword in the opening lines, so treat an orange or red result as an editing question, not a ranking emergency.
How Yoast reads your opening paragraph
The check works on content words, not the literal phrase. For languages where Yoast has function word support, small words such as "how", "to", "a" and "the" are ignored. With the keyphrase how to descale an espresso machine, the words that must appear are descale, espresso and machine.
The scoring has three levels, and Yoast's own feedback strings describe them well:
- Red: "Your keyphrase or its synonyms do not appear in the first paragraph. Make sure the topic is clear immediately."
- Orange: "Your keyphrase or its synonyms appear in the first paragraph of the copy, but not within one sentence. Fix that!"
- Green: "Well done!"
Synonyms count, which is useful if you have added them. Synonyms, related keyphrases and extra word forms are Yoast SEO Premium features, so on the free plugin you are mostly matching the keyphrase you typed.
One practical detail catches people out: the first paragraph is the test. If your post opens with a one-line hook in its own paragraph block, that single line carries the whole check, even if your second paragraph names the topic perfectly.
The newsroom habit behind the rule
The idea is older than search engines. News writers have long used the inverted pyramid: the most important facts go first, and detail follows in order of importance, so a reader who stops after one paragraph still leaves with the story.
Online, the same logic applies with more force. A searcher who clicks your result is checking, within a few seconds, whether the page answers what they typed. An opening that names the subject confirms the click was right. An opening that spends three sentences on scene-setting makes them hunt, and some of them go back to the results instead.
Yoast turned that editorial habit into a string match. The match is a proxy: it can tell whether the words are present, not whether your opening is actually clear.
Does the opening paragraph affect rankings?
Not in the way the check implies. Google reads the whole page to understand its topic, and there is no documented rule that the query must appear in the first paragraph. Plenty of pages rank well with a keyword that first appears in the third paragraph or only in a heading.
There are two indirect effects worth knowing:
- Snippets. When your meta description is missing or does not match a query well, Google may build the snippet from text on the page. A first paragraph that states the topic plainly gives it a clean candidate.
- Answer-style results. Short, direct answers near the top of a page are easy for Google to lift for featured snippets and easy for AI answer engines to quote. That is a side effect of writing clearly, not of the keyphrase being present.
So the value is real, but it comes from clarity for the reader. Getting the three words into one sentence is only a rough stand-in for that.
Writing an intro that passes and still sounds human
Start with the answer or the promise, then add context. For the espresso example:
You should descale an espresso machine every one to three months, depending on how hard your water is and how often you pull shots.
That sentence passes because descale, espresso and machine sit together, and it also tells the reader the thing they came for. Compare an opener like "Few things beat a morning coffee", which fails the check and delays the answer.
Some habits that help:
- Write the intro last, once you know what the post actually says.
- Answer the question behind the keyphrase in the first two sentences; the words tend to appear on their own.
- If the phrase is awkward to say out loud, use a natural variant and add it as a synonym in Premium, rather than forcing the exact wording.
It is fine to leave the check orange when your opening is deliberately narrative: a personal essay, a case study that opens on a scene, or a recipe with a story. Orange already means the words are in the paragraph. Moving them into one sentence rarely changes anything a reader notices.
Where Hydrogen SEO stands on openings
Hydrogen SEO does not test the position of your focus keyword. Its SEO score counts how often the focus keyword appears across the whole text (full marks between 0.5 and 2.5 percent of words), alongside content length, readability, links and image alt text. A strong opening is left to your judgment as a writer.
If you want help tightening an intro, the Hydrogen AI tab in the SEO Settings sheet can rewrite content for a goal such as clarity; see AI content tools. As with any AI draft, read it before you keep it.
Common questions
Does Yoast count my post title as the introduction?
No. The check reads the first paragraph of the body text. The title and SEO title are covered by separate checks, such as keyphrase in SEO title.
Why is the check orange when my keyphrase is clearly in the first paragraph?
Orange means every content word is present but not all in the same sentence. Put the words together in one sentence and the check turns green.
Will a red result hurt my Google rankings?
No. Google does not read Yoast's traffic lights, and it does not require a keyword in your opening paragraph. The check is a readability and clarity prompt.
Do synonyms count toward this check?
Yes. If you add synonyms in Yoast SEO Premium, a synonym whose content words share one sentence in the first paragraph also turns the check green.