Yoast SEO is a free WordPress plugin that helps you set up the title, meta description, sitemap and schema, and gives a score (red, orange or green dot) to the text of each page. To set it up, you run the first-time configuration wizard, choose one focus keyphrase per page and write an SEO title and description. A green dot shows you followed a list of best practices. It does not show that Google will rank the page first.
This guide explains the setup in the order you should do it, what each score measures and what it leaves out. The features mentioned come from Yoast’s official help center, at yoast.com/help.
What Yoast SEO is and who it is for
It is an optimization plugin for WordPress sites. It handles two areas. The first is technical: it generates the sitemap, builds the schema and controls what Google can index. The second is editorial: it sits next to the text editor and evaluates each page or post with two analyses, SEO and readability.
It works for business owners who maintain their own site, for whoever writes the store blog, and for anyone who bought a ready-made site and wants to see what’s under the hood. It doesn’t replace strategy. Deciding what the page needs to say to beat the competition is up to you, or the professional who handles your on-page SEO.
How to set up Yoast SEO step by step
To set up Yoast SEO, you install the plugin, open the General tab and complete the First-time configuration, the wizard that asks about data optimization, site identity, social profiles and personal preferences. Take your time, because the rest of the plugin builds on these answers.
- In your WordPress dashboard, go to Plugins, Add New Plugin, search for Yoast SEO, click Install Now and then Activate.
- In the sidebar menu, open the plugin menu and go to the General tab. There you’ll find the dashboard with the scores, the task list, the alert center and the First-time configuration.
- Run the First-time configuration and answer with your company’s real details: the site name, whether it represents a person or an organization, and the logo.
- Connect your company’s social profiles. They feed the schema and help Google link your site to the rest of your online presence.
- Review the wizard’s personal preferences and save.
- Go to Settings and check that the SEO analysis, readability analysis and XML sitemap features are turned on.
- Open any page and check that the plugin block appears below the editor. If it does, the installation worked.
If your site is in Portuguese, Yoast SEO offers both analyses. Yoast’s official language page lists Portuguese among the languages with almost all features, with the caveat that some finer checks, such as word complexity, don’t exist in every language. See the list by language before wondering why a test doesn’t show up.
Focus keyphrase: one per page
The focus keyphrase is the main search the page wants to answer, such as “dentist in Campinas” or “vinyl flooring replacement”. Pick one per page and write it the way your customer types it.
Two pages with the same keyphrase compete with each other. If you offer a service in several cities, each page covers one city. If the topic is the same, merge everything into a single page. To see how search terms are organized across the whole site, the SEO guide for WordPress shows the full map.
SEO title and meta description
The SEO title is the blue line that appears in the Google result. The meta description is the gray text right below it. The plugin shows a preview of both and lets you edit each one without touching the post title.
Write the title with the keyphrase near the beginning and a reason to click, in up to 60 characters so it isn’t cut off. Write the description as a short answer to what the person searched for, with the keyphrase and an invitation to click. Google sometimes shows a different snippet from the page instead of your description, and that’s normal. The details on length and wording are in the guide on meta description.
Schema and sitemap in Yoast SEO
Schema is code that describes your company and the page to search engines, and the sitemap is the list of pages you want indexed. In Yoast SEO both largely work on their own, but you need to check that they’re turned on and that they tell the truth.
The plugin’s schema builds a single graph with the site, organization, page and author. On the Schema settings screen there is an Enable Schema Framework option, and Yoast’s documentation recommends leaving it on, because turning it off changes how your content looks in the results. After making changes, test a page in Google’s validator. To understand what this code does for you, read about structured data.
The XML sitemap updates itself when you publish or remove content. The Yoast page on sitemaps says where to turn it on: Yoast SEO, Settings, Site features, Technical SEO. Content marked noindex stays off the list. So if an important page doesn’t show up in the sitemap, the first suspect is a forgotten noindex.
What the green dot measures
The green dot measures whether the page passes a fixed list of checks on the keyphrase and the writing. It looks at the page text and the fields you filled in, not at the market around you.
The plugin has two separate analyses, each with its own dot.
| Analysis | What it checks |
|---|---|
| SEO | Where the keyphrase appears (title, description, introduction, subheadings), text length, meta description filled in |
| Readability | Sentence and paragraph length, passive voice, transition words, subheadings that break up the text |
This breakdown follows Yoast’s own documentation on the two analyses. It’s useful. Ten-line paragraphs and sentences that never end really do tire readers out, and the readability analysis catches that fast. A page with no keyphrase in the title is also a real problem that the dot flags.
What the dot doesn’t measure
The plugin doesn’t measure search intent, your site’s authority or the strength of your competitors. These three things decide ranking far more than the color of the dot, and none of them appears in the plugin dashboard.
- Intent. If someone searching for a plugin’s name wants to download it, learn to use it or compare it with another, the page has to serve that need. The plugin checks whether the phrase appears in the text. It doesn’t check whether the text solves the problem.
- Authority. A new site with no outside mentions starts behind an older site that other sites cite, even with identical text.
- Competition. The dot evaluates your page alone. Ranking is decided by comparison with the other ten on the first page.
On top of that comes everything outside the text, such as loading speed, indexing, links from other sites and the mobile experience. For the technical side, the technical SEO guide explains what to look at.
In practice, a page with a green dot and generic text loses to one with an orange dot that answers the customer’s question better. The score is a draft reviewer, not a ranking judge.
Common mistakes in setup and use
The most common mistake is writing for the dot instead of the reader. The plugin reacts to simple signals, and anyone chasing the color ends up padding the text until it’s hard to read.
- Repeating the keyphrase in every sentence to turn the analysis green. The text becomes robotic and the reader leaves.
- Choosing a keyphrase nobody types just because it’s easy to fit in.
- Using the same keyphrase on several pages of the same site.
- Leaving the meta description blank and accepting the snippet the plugin suggests on its own.
- Forgetting a noindex after a period of site work, and the page disappears from the sitemap.
- Treating the plugin as if it were all of SEO. It organizes the foundation. Content, links and authority come from outside it.
- Installing a second SEO plugin on top of the first, which creates duplicate titles and schema.
If the page doesn’t climb, the way forward is to compare it with the ones above it. An SEO audit does exactly that comparison, page by page.
Yoast SEO or Rank Math
Rank Math is the best-known alternative to Yoast on WordPress, and choosing between them is a matter of interface and preference, not guaranteed results. Both generate a sitemap and schema, and neither puts a page in first place. Rank Math has a different setup wizard and a different list of tests, which I cover in the article on Rank Math. If you already use one and are happy with it, switching won’t change your ranking.
Frequently asked questions
Is Yoast SEO free? There is a free version that covers most small sites, and a paid version with extra features. The setup described here works on the free one.
Does Yoast SEO work in Portuguese? Yes. The official documentation lists Portuguese among the languages with SEO and readability analysis, with some advanced checks unavailable.
Does a green dot guarantee first place on Google? No. It shows that the text passed the plugin’s checks. Ranking also depends on search intent, site authority and competition.
What is the ideal focus keyphrase? It’s the main search the page wants to answer, written the way the customer types it and used on only one page of the site.
Does the sitemap create itself? It’s created and updated automatically when you publish or remove content. Pages marked noindex are left out.
Do I need Yoast if I already use Rank Math? No. Use one SEO plugin at a time, so you don’t duplicate titles and schema.
Want to know what your site really needs?
The color of the dot is only the start of the conversation. See how Ciclicko handles on-page SEO and GEO so your site shows up where your customers search.