How to Add a Focus Keyphrase in Yoast SEO
To add a focus keyphrase in Yoast SEO, open the post or page in the WordPress editor, click the Yoast (Y) icon in the top right corner to open the Yoast SEO sidebar, and type your phrase into the “Focus keyphrase” field at the top. You can also scroll down to the Yoast SEO meta box below the editor, which holds the same field. As soon as the phrase is in, the SEO analysis checks the post against it and shows green, orange or red bullets, and the phrase is saved when you save or update the post. The free plugin takes one focus keyphrase per post, and the rest of this guide covers choosing a phrase that matters, what each check wants, and what to do when the field is not there.

Where the focus keyphrase field is, step by step
Yoast puts the same field in two places, and which one you use is a matter of taste. In the block editor, the sidebar is the quicker route, while the meta box below the content suits people who write in the classic editor or like to see the analysis under their text. Yoast’s own help article on the sidebar lists the focus keyphrase as the first thing to set, because the SEO analysis has nothing to measure until it is filled in.

- In WordPress, open the post or page you want to optimize (or start a new one).
- In the block editor, click the Yoast (Y) icon in the top right corner of the screen. If you use the classic editor, scroll below the content box to the Yoast SEO meta box.
- Type the phrase into the “Focus keyphrase” field. Use the words a searcher would type, not your internal name for the topic.
- Open the “SEO analysis” section to read the feedback. Each check has its own bullet, and the overall traffic light combines them.
- Edit the post, title, slug or meta description in response, then save or update the post so the keyphrase and your changes are stored.
If you never set a keyphrase, Yoast’s help article says the SEO analysis traffic light stays grey. That is not an error on the page, only a sign that the plugin has nothing to check the content against.
When the focus keyphrase field is missing
A field that has vanished is a common enough problem that the top Calgary result for this search is a WordPress.org support thread about it. In most cases the field has been switched off rather than broken, and Yoast documents four places where that can happen. The first is site-wide: in Yoast SEO, go to Settings, then Site features, and check that the SEO analysis switch is on. The second is per content type: under Settings, open Posts, Pages or the custom post type you are editing, and make sure “Enable SEO controls and assessments” is ticked under Additional settings.
The other two are per person and per screen. Each user’s WordPress profile has a “Disable SEO analysis” box, which explains the case where an editor sees the field and the site owner does not. In the block editor, the three-dot menu at the top right has a Preferences screen with a Yoast SEO toggle under General, and in the classic editor the Screen Options tab at the top of the page has a Yoast SEO tick box. If all four are on and the field still does not appear, Yoast’s support staff in that WordPress.org thread asked the user to look for JavaScript errors in the browser console, since a theme or plugin conflict can stop the box from loading. A clean setup from the start avoids most of this, and there is a separate walk-through on configuring Yoast SEO for new sites.
How to choose a focus keyphrase that matters
The field accepts anything, so the real skill is in what you type. Yoast’s own advice comes down to three steps: find a phrase people search for, check how often it is searched, and google it yourself to see whether the results match the kind of page you are writing. If the results are product pages and you are writing a blog post, or the reverse, the phrase is the wrong fit no matter how many green bullets you collect. Proper keyword research does this across a whole site, but for a single post those three checks catch most mistakes.

For a post that is already published, the best evidence is the searches it already appears for. The Queries tab in the Search Console performance report lists the terms people typed when the page showed up, and a phrase with steady impressions but a position on page two is often a better focus keyphrase than the one you guessed at when writing. If you also run a Google Ads campaign, its search terms report shows the actual searches that triggered your ads, which is a direct record of how customers phrase the need in your market.
Three Yoast rules shape the choice. First, length: Yoast ignores function words such as “the”, “a” and “in” in English and counts only content words, and it flags a keyphrase with more than four of them (six in languages where it cannot filter function words). As an illustrative example, a Calgary heating company could use “emergency furnace repair Calgary”, which is four content words, but “emergency furnace repair Calgary NW” goes over the limit. Second, one keyphrase per page: the “previously used keyphrase” check warns you when another post already targets the same words, because two pages chasing one query tend to compete with each other, and Yoast’s advice is to improve the original instead. Third, spelling: the free analysis matches the words as you type them and only Premium recognizes other word forms, so on a Canadian site it makes sense to pick the spelling your searchers use, such as “colour” or “color”, and treat the other spelling as a synonym rather than a second target.
What Yoast checks once the keyphrase is set
Yoast lists more than 15 checks in its SEO analysis, and most of them use the focus keyphrase. A detail that explains many confusing bullets is how Yoast counts a match. It splits the keyphrase into its content words and looks for all of them in the same sentence, in any order, so “add a focus keyphrase in Yoast” can be matched by “Yoast lets you add the focus keyphrase in seconds”. The table below sets out the keyphrase checks as Yoast describes them on its features page.
| Check | What Yoast looks for | Free or Premium |
|---|---|---|
| Keyphrase in introduction | Words from the keyphrase in the first paragraph, ideally in one sentence | Free |
| Keyphrase length | No more than four content words in English | Free |
| Keyphrase density | Enough uses but not too many; green between 0.5% and 3% in the free version (3.5% in Premium), reported as a count | Free |
| Keyphrase in meta description | All content words of the keyphrase in one sentence of the meta description | Free |
| Keyphrase in subheadings | At least one content word from the keyphrase in subheadings | Free |
| Keyphrase in title | The keyphrase used in the SEO title | Free |
| Keyphrase in slug | The keyphrase used in the URL | Free |
| Keyphrase in image alt attributes | The keyphrase or a synonym in image alt text | Free |
| Link focus keyphrase (shown as “Competing links” in the plugin) | Links in your text that use the keyphrase or a synonym as their anchor text; it turns green when there are none | Free |
| Previously used keyphrase | Whether another post already uses the same keyphrase | Free |
| Keyphrase distribution | How evenly the keyphrase and its synonyms are spread through the text | Premium |

Fixing the common orange and red bullets
Most orange and red bullets have a simple cause. A red introduction check usually means the keyphrase words are spread across two sentences rather than sitting in one, so rewriting the opening sentence to state the topic plainly fixes it, and Yoast itself recommends the first sentence where it reads naturally. A density warning tells you how many times you used the phrase and how many it expects, and the longer your keyphrase, the fewer uses Yoast asks for, since it weights the count by length. A meta description warning disappears once the description contains every content word of the phrase in one sentence, which is usually also a clearer description.
The slug check deserves more caution than the others. On a new post, a short slug that contains the keyphrase is easy, but on a page that is already published and indexed, changing the slug changes the URL, which means setting up a redirect and waiting for Google to process it. A bullet in a plugin is rarely worth that cost on its own. The same judgement applies to subheadings and alt text: add the words where they describe the section or the image, and leave them out where they would read as stuffing.
What Google sees, and why green bullets are not rankings
The focus keyphrase never reaches Google. Yoast stores it in WordPress for its own analysis and does not print it in the page code; the source of this very page, which runs Yoast SEO Premium, contains no keywords meta tag. Even where a site does output one, Google’s documentation on meta tags says the meta-keyword tag is not used by Google Search and has no effect on indexing and ranking at all. What Google reads is the page itself: the title, the headings, the text and the links pointing to it.

That makes the analysis a writing aid rather than a ranking score. A page can be green across the board and still sit on page five because stronger pages answer the query better or have more links, and a page with orange bullets can rank well. Pushing the density up to chase a bullet carries its own risk, because Google’s spam policies list keyword stuffing, repeating words so often that they sound unnatural, as a violation. The snippet preview is useful too, as long as you treat it as an estimate: Google says it builds snippets primarily from the page content and sometimes uses the meta description when it gives a more accurate summary, so the description you write may not be the one searchers see.
Related keyphrases, synonyms and cornerstone content
Yoast SEO Premium adds three things around the focus keyphrase. You can add up to four related keyphrases per post, each with its own, slightly less strict analysis; you can enter synonyms, which the introduction, subheading, alt text and distribution checks then accept; and the analysis recognizes word forms such as plurals and verb tenses in English and a number of other languages. Synonyms are covered in more detail in a separate article on keyphrase synonyms, and they are the cleanest answer to the spelling problem above.

Cornerstone content is available in the free plugin. Switching on the cornerstone toggle for a post replaces the default analysis with a stricter one: Yoast says it adjusted two readability checks and six SEO checks, and the text length check wants at least 900 words before it turns green. Use it on the handful of pages that matter most to the business, not on every post, since the point is to hold your most important pages to a higher standard. Whether the Premium features justify the yearly fee depends on how much you publish, and there is a fuller look at whether Premium is worth paying for.
A short routine before you publish

Running through the same few checks on every post keeps the focus keyphrase useful without letting it take over the writing. The list below takes a few minutes once it is a habit.
- The keyphrase is a phrase people search for, and the current results match the kind of page you wrote.
- It has four content words or fewer and is not already the focus keyphrase of another page.
- The opening sentence states the topic in plain words that include the keyphrase.
- The SEO title and meta description contain it once and read like a person wrote them.
- Any remaining orange bullets were left on purpose because fixing them would make the text worse.
After publishing, give Google a few weeks and then look at the page’s queries in Search Console; if it is showing for a different phrase than the one you chose, that phrase may be the better focus keyphrase. If you would like a second opinion on keyphrase choices across a whole site, SEO Company To-The-TOP! is a Calgary practice that has worked on search since 2007, and you can reach it through the To-The-TOP! home page or by calling (403) 308-5949.
Contact Calgary SEO Company To-The-TOP!
Questions about anything in this article, or about your own rankings? Talk to a Calgary SEO specialist directly.
Phone: (403) 308-5949
Address: 1509 14 Ave SW, Calgary, AB T3C 0W4
Hours:
Monday to Friday: 10:00 am – 7:00 pm
Saturday: 12:00 pm – 4:00 pm
Sunday: closed
