Yoast and Rank Math Meta Description Not Working: How to Fix It

What not working usually means

When people say their Yoast or Rank Math description is not working, they usually mean one of four things. The first three are problems on the site and can be fixed. The fourth is Google's choice and is covered in why your meta description is not showing in Google.

So the first job is always to look at the HTML the live page sends. The plugin's editor preview only shows what the plugin intends to print. It cannot tell you whether the theme, a cache or another plugin changed the result.

How to find the source of each tag

Open the live page in a private window, so you are not logged in, and view the source. Search for name="description". Then look at the lines around it. Both plugins wrap their output in HTML comments that name the plugin, so you can see at a glance which tags belong to them. Yoast's block starts with a comment naming Yoast SEO and its version and ends with a closing <!-- / Yoast SEO plugin. --> comment. Rank Math's block starts with a comment naming Rank Math and ends with <!-- /Rank Math WordPress SEO plugin -->.

From the command line, this shows every description tag and every plugin comment in order:

curl -s https://www.example.com/services/ \
  | grep -inE 'name="description"|yoast seo|rank math'

If a tag outside the comments remains a mystery, switch briefly to a default theme such as Twenty Twenty-Five on a staging copy and check again. If the extra tag disappears, it came from the theme. If not, deactivate other plugins one at a time. On a live site, use a staging copy or a plugin that switches theme only for logged-in administrators.

The common causes

The theme does not call wp_head

SEO plugins print their tags through the wp_head hook. A classic theme must call it in header.php, just before the closing head tag. Block themes handle this automatically. Old or custom-built themes sometimes leave it out, and then no plugin can add anything to the head.

    <?php wp_head(); ?>
</head>

A description hard-coded in the theme

Older themes and ones copied from a template often have a line like this in header.php, which prints the same text on every page:

<meta name="description" content="<?php bloginfo('description'); ?>">

It prints the site tagline as a description on every page, in addition to the plugin's tag. Remove it in a child theme copy of header.php, so a theme update does not bring it back.

Theme SEO settings or a second plugin

Some themes and page builders include their own SEO fields. Divi, for example, has description options under its theme options, and some all-in-one performance or schema plugins add meta tags too. Running Yoast and Rank Math together is the most obvious version of this. Keep one source for descriptions and switch the others off.

wp plugin list --status=active --field=name | grep -iE 'seo|yoast|rank|schema'

Caching

Page caching plugins such as WP Rocket, LiteSpeed Cache or W3 Total Cache, server caches in Plesk or nginx, and CDNs such as Cloudflare all keep serving the HTML they stored before your change. Purge each layer after editing descriptions, then fetch the page again with curl to confirm the new text arrives.

Where each description is set

Many cases of the wrong description turn out to be the right description set in the wrong place. Both plugins have three levels: the individual post, page or term; a default template for each content type; and site-wide home page settings.

Check Settings, Reading in WordPress to see whether your home page is a static page or a list of latest posts. Editing the wrong one of these is a very common reason a home page description refuses to change.

Template variables that print nothing useful

Default templates use variables, such as %%excerpt%% in Yoast or %excerpt% in Rank Math. Both plugins try to build an excerpt from the content when there is none, but this can produce nothing or a jumble when the page is built with a page builder whose content sits in shortcodes or blocks. Yoast's %%excerpt_only%% uses only a hand-written excerpt and prints nothing if there is none. If a template produces an empty result, no tag is printed. For your important pages, write the description by hand rather than relying on the template. The broader WordPress picture is in fixing meta tags on WordPress.

Fixing it in code when settings are not enough

If you cannot remove a hard-coded tag through settings, do it in a child theme or a small site-specific plugin rather than editing the parent theme. To change what the SEO plugin prints for particular pages, both plugins provide filters:

// Yoast: change the description on product archive pages
add_filter( 'wpseo_metadesc', function ( $desc ) {
    if ( is_post_type_archive( 'product' ) ) {
        return 'Hand-made oak furniture, built to order in the UK and delivered free.';
    }
    return $desc;
} );

// Rank Math: the equivalent filter
add_filter( 'rank_math/frontend/description', function ( $desc ) {
    if ( is_post_type_archive( 'product' ) ) {
        return 'Hand-made oak furniture, built to order in the UK and delivered free.';
    }
    return $desc;
} );

Use only the filter for the plugin you run. After adding code, purge caches and check the source again. If the description still does not change, the tag you are looking at is not coming from the plugin at all.

Headless sites and page builders

If your front end is built separately from WordPress, for example with Next.js reading content through the REST API, the plugin's tags never reach visitors unless the front end prints them. Yoast adds a yoast_head_json field to REST API responses for posts and pages. Rank Math offers a head endpoint once headless support is switched on in its settings. Your front end has to read one of these and output the description in its own head. See meta tags in Next.js for the front-end side.

curl -s "https://cms.example.com/wp-json/wp/v2/pages?slug=services" \
  | grep -o '"description":"[^"]*"' | head -1

Page builders such as Elementor normally work fine with either plugin, because they leave the head to WordPress. Problems arise when a builder's theme or template kit adds its own SEO features, or when a custom header template is built without the standard head output. The same view-source check finds both.

The fix, step by step

Edge cases worth knowing

• Paginated archives such as page 2 of a category may use a different template from page 1.
• Translation plugins keep a separate description for each language. Check you edited the right language version.
• Noindexed pages still print a description, but Google will not show it because the page is not in results.
• Sitewide caches by device may hold separate mobile and desktop copies. Purge all of them.
• Imported or migrated content can carry description fields from an old SEO plugin that the new one does not read. Use the plugin's import tool rather than retyping.

Keeping descriptions working

• After every theme or plugin update, check the source of your home page and one post for exactly one description tag inside the plugin comments.
• Keep one SEO plugin. Before trying a second, export settings and fully remove the first.
• Write descriptions by hand for your main pages; use templates only for long tails of posts and products.
• Purge caches as part of any description change, and test with curl rather than a logged-in browser.
• Use URL Inspection in Search Console to confirm Google sees the same tag you see.

If many pages end up with the same description, follow fixing duplicate meta descriptions.