How to Use Focus Keywords in Yoast SEO: Complete Guide
The focus keyword field in Yoast SEO is one of the most visible and most misunderstood features in the WordPress SEO ecosystem. Millions of sites have it installed. A significant portion of those sites either leave the field empty or fill it with something that does not match the actual content strategy.
This guide explains what the field does, how to use it effectively, and how to scale keyword assignment across a large WordPress site without spending hours in the editor.
Where the focus keyword field lives
In the Yoast SEO meta box below the WordPress editor, there is a field labeled Focus keyphrase. This is where you declare the main search phrase you want the page to target.
Yoast stores this value in the WordPress postmeta table under the key _yoast_wpseo_focuskw. This technical detail matters because other plugins and workflows can read and write to this field programmatically, which is the foundation of the pipeline approach documented on this site.
The field accepts a single phrase (Yoast Free) or multiple phrases (Yoast Premium). For the purposes of automated workflows, including Auto Focus Keyword and Automatic Internal Links, the primary focus keyphrase is the field that matters.
What Yoast does with the focus keyword
When you enter a focus keyword, Yoast runs a series of checks against your page content and metadata. It evaluates whether the keyphrase appears in the SEO title, the meta description, the URL slug, the first paragraph of the content, the subheadings (H2, H3), the body text at an appropriate density, the image alt attributes, and internal and external links on the page.
The result is a color-coded score: green (good), orange (needs improvement), or red (significant issues). This score is displayed as a traffic light in the post list and inside the Yoast meta box.
It is important to understand what this score is and what it is not. The Yoast SEO score is an editorial guide that helps you verify alignment between your declared keyword target and your actual content. It is not a ranking factor. Google does not see your Yoast score, does not know what your focus keyphrase is, and does not use it directly in ranking calculations. The value of the field is operational and organizational, not algorithmic.
How to choose the right focus keyword
A good focus keyword meets four criteria.
It reflects actual search intent. The keyword should match the way real people search for the topic the page covers. A product page for wireless headphones should target "wireless headphones" or a more specific variant, not "audio equipment" or "electronics."
It is specific enough to avoid cannibalization. If you have 10 pages targeting "WordPress SEO," those pages compete with each other. Each page should have a keyword specific enough to distinguish it from neighboring content on your site.
It works as potential anchor text. This is an often-overlooked criterion. When Automatic Internal Links creates links using focus keywords as anchor text, the keyword becomes visible to both search engines and readers. A keyword like "internal linking best practices for WordPress" makes excellent anchor text. A keyword like "stuff" does not.
It is stable enough for the long term. The focus keyword defines the optimization target for the page. If the keyword changes constantly, the SEO signals become inconsistent. Choose a keyword you expect to remain relevant as the page evolves.
Common mistakes with Yoast focus keywords
Leaving the field empty. This is the most common problem, especially on large sites with legacy content. Empty focus keyword fields mean no optimization target, no meaningful Yoast analysis, and no data for automated linking systems. Auto Focus Keyword addresses this by filling empty fields from page titles in bulk.
Choosing keywords that are too broad. "SEO" is not a useful focus keyword. Neither is "WordPress" or "marketing." These terms are too competitive and too vague to serve as optimization targets for a single page.
Duplicating keywords across multiple pages. When three blog posts all use "WordPress SEO tips" as their focus keyword, they cannibalize each other. After bulk keyword assignment, review for duplicates and refine.
Ignoring the downstream impact. Your focus keyword is not just a Yoast analysis field. It is consumed by other plugins in the ecosystem. Automatic Internal Links uses it as anchor text. BIALTY uses it for image alt text. Poor keyword choices cascade through every system that reads the field.
The scale problem
On a small site with 20 pages, you can fill the focus keyword field manually for each page in a few minutes. On a site with 500 blog posts, 300 WooCommerce products, and 50 service pages, manual assignment becomes a significant time investment that most teams never complete.
This is where Auto Focus Keyword for SEO becomes essential. The plugin scans your site for published content where the Yoast focus keyword field is empty, then populates it from the page title in a single batch operation.
The page title is a practical default for several reasons. On product pages, the product name is almost always the ideal focus keyword. On blog posts with descriptive titles, the title closely matches the intended search query. On service pages with straightforward names, the title reflects the topic accurately.
For pages where the title is creative, branded, or otherwise not search-oriented, the auto-assigned keyword serves as a starting point that can be refined manually during a follow-up review. The hybrid approach — automate for coverage, review for precision — is the recommended workflow.
Focus keywords and the internal linking pipeline
The focus keyword field is not just an editorial signal for Yoast's traffic light analysis. It is also the primary input for automated internal linking.
Automatic Internal Links for SEO reads the focus keyword stored in _yoast_wpseo_focuskw, scans your content for text that matches that keyword, and creates internal links using the keyword as anchor text. This means the quality of your focus keyword choices directly affects the quality of your internal link network.
If your focus keyword is "WordPress internal linking best practices," the plugin will look for that phrase (and partial matches if enabled) across your site and create links pointing back to that page. If your focus keyword is something vague like "guide" or "info," the resulting anchor text will be meaningless and potentially harmful.
This connection is why the pipeline documentation emphasizes that Auto Focus Keyword is Step 1 and Automatic Internal Links is Step 2. The keyword layer must be coherent before the linking layer can operate effectively.
Yoast Free vs Yoast Premium
Yoast SEO Free allows one focus keyphrase per page. Yoast SEO Premium allows additional related keyphrases and provides more advanced content analysis features.
The Auto Focus Keyword and Automatic Internal Links plugins work with the primary focus keyphrase field in both editions. The additional keyphrases available in Yoast Premium are stored differently and are not consumed by the linking pipeline. The primary keyphrase is the field that matters for automated workflows.
Step-by-step workflow for Yoast SEO users
- Install and activate Yoast SEO — ensure the plugin is active and the SEO meta box appears below your editor.
- Install Auto Focus Keyword for SEO — download from WordPress.org.
- Select your post types — choose which content types to process (posts, pages, products if using Pro).
- Run FETCH — the plugin identifies all published content where the Yoast focus keyphrase field is empty.
- Run SYNC — the plugin writes the page title into the empty focus keyphrase field for every identified page.
- Review your top 20 most important pages — refine the auto-assigned keyword manually in the Yoast meta box where the title does not match the ideal keyword target.
- Install Automatic Internal Links for SEO — download from WordPress.org.
- Configure settings — select post types, set max links, configure exclusions.
- Run SYNC — the plugin scans your content for focus keyword matches and creates internal links.
- Verify on the frontend — check that links appear correctly with appropriate anchor text and destinations.
FAQ
Does Auto Focus Keyword overwrite existing Yoast focus keywords?
No. The plugin only fills fields that are currently empty. Existing keywords are preserved unchanged.
Can I use a different keyword than the page title?
Yes. After the batch SYNC, you can change any focus keyword directly in the Yoast meta box. The auto-assigned value is a starting point, not a permanent lock.
Does the pipeline work with Yoast Premium?
Yes. It reads and writes to the same primary focus keyphrase field used by both Yoast Free and Yoast Premium. Premium's additional related keyphrases are a separate feature.
What about the Yoast SEO score — will it change?
Yes. Once a focus keyword is assigned, Yoast will start showing its traffic light analysis for that keyword. Pages that previously showed no analysis will now have a green, orange, or red score based on how well the content aligns with the assigned keyword.