How to use Yoast SEO's content analysis tool

The content analysis tool in the Yoast SEO plugin assesses many aspects of the articles you add to your website. Working in real time (so you get feedback as you write) it checks how SEO-friendly and easy to read your content is. This post goes through the most important features of the content analysis tool and how to use and interpret the feedback it gives you.

Most important features

Readability tab

The content analysis contains two tabs. The first is the readability analysis, which includes several readability checks:

If you write a readable text, based on the criteria above, the plugin will reward you with a green bullet.

The Insights tool checks the words you use most often in your article, helping you to see if your text actually matches your chosen keyword. Your focus keyword should appear on this list. If it doesn’t, you might want to rework your article or even add a second focus keyword with Yoast SEO Premium if necessary.

SEO analysis tab

The second tab is the SEO analysis, where you’ll find the snippet editor, the field for your focus keyword – and various other SEO checks.

The snippet editor allows you to create your meta description, which should be a short piece of text describing the main topic of your piece. If your meta description includes the actual term people search for, that exact text will be shown by Google below your URL in the search results. But often Google automatically generates a meta description, because, sometimes, Google knows best.

Once you’ve entered your focus keyword, the SEO analysis checks the presence of your focus keyword in:

Learn how to write awesome and SEO friendly articles in our SEO copywriting training »

SEO copywriting training Info

The plugin also checks for links and images in the article. It calculates the number of words and frequency of the focus keyword in your article. The plugin also checks whether you’re using the exact same focus keyword on other pages of your website so you don’t accidentally compete with yourself.

If you were to optimize two different articles for the same focus keyword, you could have both posts turn up in the same search on Google. Read why you shouldn’t use your focus keyword more than once.

If you write a relatively SEO-friendly article (based on the above criteria), the plugin will reward you with a green bullet. Incidentally, some people call them green lights, but we prefer to say bullets. If you follow the instructions and craft your pages and posts so they get green bullets, they will rank better in search. But what if you have all green bullets and still no rankings?

Read more: SEO copywriting: the ultimate guide »

Beware: content comes before SEO!

In the content analysis tool, content comes before SEO, so first and foremost you have to write awesome content. Put your effort into writing an attractive, structured and readable article and then use our content checks to make sure your text is nice and easy to read.

Once you’re done optimizing your text for readability, look at the checks on the SEO analysis tab. If you’ve done your keyword research properly and you’ve written your post or your article with a focus keyword in mind, don’t change it now! Why? See The temptation of the green bullet to find out.

8 simple steps to optimize your text

Step 1: Put your text in the WordPress backend

Distraction free writing

WordPress has a distraction-free writing mode that enables you to write in the WordPress backend without being distracted by the menu, the toolbar, the categories box, etc.Distraction free writing mode

You can write your article directly into the backend of WordPress or write in any text editor and copy and paste it into the WordPress backend. Either way is fine!

If you choose to paste your text into the WordPress backend, copy without any formatting. This is because all the formatting should be done within WordPress to avoid layout compatibility issues carried across from another program. Make sure you set subheadings to heading 2, sub-subheadings to heading 3, etc. Then put the title of your post – your heading 1 – in the title box.

Step 2: Check your readability scores

Click on the readability analysis tab and you’ll see your scores for the readability checks. The green bullets show which aspects of your content are good, while orange and red bullets indicate where you can make improvements. Clicking on the little eye will highlight the sections where the analysis identified a problem. These content checks will help you make your article easier to read. Make sure that the overall bullet (the one on the upper right in the backend of your post) is green. The overall bullet will turn green if you have covered most of the readability aspects.


Step 3: Make some content adjustments

The readability analysis checks tell you where your article’s readability could be improved, and some of these issues will be easy to fix. If you tend to write long sentences, our analysis will tell you which ones to rewrite. Split long sentences up into shorter sentences. If your paragraphs are too long, divide them up too. If you use a lot of passive voice, rephrase a few sentences. Add extra subheadings if the analysis tells you that your subheading distribution isn’t optimal.

If your text scores any red bullets on transition words or Flesch Reading Ease, making improvements will be more difficult. Your Flesch Reading Ease score will improve with shorter sentences, but you should also check whether you have used too many difficult words (words of more than four syllables). Are there shorter, simpler alternatives you can use?

Optimize for synonyms and related keywords and prevent broken pages on your site with Yoast SEO Premium! »

Yoast SEO: the #1 WordPress SEO plugin Info

Transition words aid readability and if the analysis suggest you add more, you can improve things by adding them – but don’t just throw them in at random. Look at the structure of your text and decide where transition words will work. Which words would make the relation between paragraphs – and between sentences – clearer to your readers? Perhaps you make some points that can be listed numerically, so you could add transition words like ‘firstly’, ‘secondly’ and ‘finally’. And maybe you could add transition words in your conclusion as well. Could you use words like ‘summarizing’ or ‘therefore’ in your final paragraphs?

Step 4: Enter your focus keyword

Once you’ve finished optimizing your article’s readability, move on to the SEO analysis. Click on the SEO tab and enter your focus keyword – the keyword you want your post to rank for – in the appropriate field of the Yoast SEO Metabox. This should be a keyword which came from your keyword research and which you kept in mind throughout the writing process.

Keep reading: How to choose the perfect focus keyword »

Focus keyword in Yoast SEO

Yoast SEO Premium lets you optimize an article for more than one focus keyword. Optimizing your post for multiple keywords lets you to rank the same content for more keywords and to get more traffic to your site.

Step 5: Write a meta description

Enter the meta description, describing clearly what your post or article is about. And make sure you use the exact phrase used in your focus keyword. The meta description will be shown by Google below the URL if people search for your focus keyword.

meta description yoast seo

The meta description should include your focus keyword, not because it will improve your rankings, but because otherwise Google usually won’t display it in the search results. Google will always try to match the search query with the description. If the focus keyword isn’t mentioned in the meta description, Google will just grab a random piece of content containing the keyword from your page instead.

While there’s no ‘penalty’ for having meta descriptions that are too long, it’s still a good idea to keep them short if you can. You should make sure that: 1. it fits the character limit and; 2. it still makes sense when it’s cut in half, and still entices people to click.

Read on: How to create the right meta description »

 Step 6: Check your SEO bullets!

Now check out those SEO bullets! Again, green tells you which aspects of your SEO are good, while orange and red indicates where you can improve your SEO strategy. However, you don’t have to keep on optimizing until all of the bullets are green. Posts on often have a few orange bullets and sometimes even one or two red ones. The important thing is that the overall bullet (the one on the upper right in the backend of your post) should be green, which happens if most of your SEO aspects are covered.


Optimize your site to the max: get all our SEO plugins and extensions at once! Get our Yoast Complete SEO bundle and save money! »

Yoast Complete SEO pack Info

Content-analysis-tool- (1)

Step 7: Make some SEO adjustments

The checks in the SEO analysis will show you where you can improve your SEO. Look critically at your title, the headings, and subheadings of your article. Do they include your focus keyword? If not, can you edit them (without changing the structure or content of your article) to include your focus keyword? Don’t go crazy and put your focus keyword in every heading, because that’s too much! Using your focus keyword in one heading and your title should be enough. You can read more about headings in one of Michiel’s posts.

Your article should also include the focus keyword a couple of times, and if it’s not in your first paragraph, add it. As a general rule of thumb: try to use your search terms in about 1 to 2 percent of your text. Say your article has 300 words, you’ll need to mention your search terms 3 to 6 times. That’s not to say 300 words, or the number of keyword mentions is an exact goal. However, 300 is the minimum length for an article that needs to show authority.

Step 8: Fill out the social data

The final step in the Yoast content analysis tool is to add the social data for your article. Any description or title you add on this tab for use by a social network will be shown in the metadata for the page. This means that this description, title or image will be shown when the page is shared on a particular social network. These descriptions have the same requirement as the meta description (which is what they fall back to), but can usually be longer. They should tell people what to expect and why they should click.

Social previews

The preview screenshots on the left are taken from Yoast SEO Premium, in the free version, you won’t see those previews, just the fields!

social tab yoast seo premium

Cornerstone analysis

Because your cornerstone articles should be the best articles on your site, and you want them to rank high in the search engines, Yoast SEO provides a specific cornerstone content analysis. If you mark an article in Yoast SEO as cornerstone content, the content analysis will be a little stricter – your article will need to be longer, for example. You can also check if these articles are linked to often enough elsewhere on your site with the text link counter in Yoast SEO.


SEO copywriting is still hard work, but the content analysis tool in Yoast SEO makes the process of writing awesome, SEO-friendly articles much easier. For more practical tips, make sure you read SEO copywriting: the Ultimate Guide. We are continually working on more checks to add to our content analysis, so stay tuned!

Keep on reading: The ultimate guide to content SEO »

Check out our must read articles about WordPress

WordPress SEO

This is the ONLY tutorial you'll need to hugely increase your search engine traffic by improving your WordPress SEO. Includes plugin, theme & site structure tips. Higher rankings, more visitors and a better site? Read on!

Read article »

The best WordPress hosting

Simply finding the best WordPress hosting is hard: there's a lot of WordPress hosting offers out there, and only a few companies are actually good!

Read article »

WordPress security in a few easy steps

Simple steps you can take today to improve your site's security. This WordPress security guide we wrote in collaboration with Sucuri has it all!

Read article »