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

Short answer
First view your page source and search for the description tag. If your text is there, Rank Math works and Google is either rewriting the snippet or has not recrawled yet. If it is missing or wrong, clear caches, remove duplicate tags from other plugins, and fill the description field or template.
Key takeaways
- Check the page source first to see what tag Rank Math outputs.
- Google often rewrites descriptions, and no setting can force it to use yours.
- Request indexing in Search Console after changing a description.
- Clear plugin, server and CDN caches if the source shows old text.
- Remove duplicate description tags from other SEO plugins or the theme.
- Static homepages take their description from the page, not the Homepage tab.
Why is my Rank Math meta description not working?
Most of the time Rank Math is outputting the description correctly and Google is simply choosing different text, but caching, a duplicate tag from your theme, or an empty template can also be to blame.
The phrase not working can mean two different things:
- The tag is missing or wrong in your page's HTML. That is a site problem you can fix.
- The tag is correct, but Google shows other text. That is Google's choice, and you can only influence it.
The first step is to work out which one you are dealing with. The rest of this guide covers both. If Rank Math seems broken in other ways too, see our wider guide to Rank Math SEO not working.
How do you check whether Rank Math is outputting the description?
Open the page in a private browser window, view the page source, and search for name="description" to see exactly what description tag the page sends.
Here is how:
- Log out, or open a private window so you see the cached public version.
- Visit the page.
- Right-click and choose View Page Source, or press Ctrl+U (Cmd+Option+U on a Mac).
- Press Ctrl+F and search for
name="description".
Now compare what you find with what you typed in Rank Math.
| What you see in the source | What it means | Where to look next |
|---|---|---|
| Your new description | Rank Math works; Google has not updated or chose other text | Google sections below |
| An old description | Cached page | Clear caches |
| Two description tags | Another plugin or theme adds one | Duplicate tags section |
| No description tag | Empty field and template, or Rank Math not running | Templates section |
The MDN reference on standard meta names explains what a valid description tag looks like.
Is Google rewriting your meta description?
Google often shows its own snippet instead of your meta description when it thinks other text on the page better matches the search, and no plugin setting can force it to use yours.
Google says clearly in its snippet documentation that it uses the meta description only when it gives a more accurate summary than the page content. The snippet can change from one search to another.
You are more likely to see your own description when it:
- Accurately summarizes the page, not just the keyword.
- Is unique to that page, not shared with other pages.
- Is a reasonable length, roughly 120 to 160 characters.
- Matches the intent of the searches that bring people to the page.
Try searching for the exact page title or brand name. For those searches, Google is more likely to show your written description. For long, specific searches, it often pulls a sentence from the page that matches the query.
Has Google recrawled the page yet?
Google keeps showing the old description until it crawls the page again, which can take days or weeks, so a recent change may simply not be visible in search yet.
You can speed things up with Google Search Console:
- Open the URL Inspection tool.
- Paste the page URL.
- Click Test Live URL to confirm Google sees the new tag.
- Click Request Indexing.
Requesting indexing does not guarantee an instant update, but it adds the page to Google's queue. Our guide on how to get WordPress pages indexed faster has more tips.
Could caching be showing an old description?
Yes, if your page source shows the old text, a page cache, server cache or CDN is serving a stored copy, and you need to purge it before the new description appears.
Clear every layer in this order:
- Your caching plugin, such as LiteSpeed Cache, WP Rocket or W3 Total Cache.
- Your host's server cache, often a button in the hosting dashboard.
- Your CDN, such as Cloudflare.
- Your browser, or simply test in a private window.
Then check the page source again. Our guide on how to clear cache in WordPress covers each common plugin and host.
If clearing cache fixes it every time, set your cache plugin to purge a page automatically when it is updated. Most caching plugins do this by default.
Is another plugin or your theme adding a second description tag?
Yes, this is common: themes with built-in SEO fields, page builders and leftover SEO plugins can add their own meta description, leaving two tags that confuse search engines.
Look in your page source for more than one name="description" line. If you find two, track down the second source:
- Another SEO plugin. Yoast SEO, All in One SEO or SEOPress left active alongside Rank Math. Keep only one. Our guide on whether you can use Rank Math and Yoast together explains why.
- Your theme. Some themes have an SEO panel with a description field. Turn it off in the theme options.
- Hardcoded tags. A developer may have added a meta tag to the theme's header file. Remove it from the child theme.
- Header code plugins. Check any plugin you use to insert code into the head.
The source code often has an HTML comment such as Rank Math WordPress SEO plugin near Rank Math's tags. Anything outside that block came from somewhere else.
Is the description field or template empty?
If you left the page's description blank, Rank Math falls back to the default template in Titles & Meta, and if that template is empty or uses an empty excerpt, no description is output.
Check the page first:
- Open the post or page and go to the Rank Math panel.
- Click Edit Snippet.
- Confirm the Description field has text, then update the post.
Then check the defaults:
- Go to Rank Math > Titles & Meta.
- Open the tab for your post type, such as Posts or Pages.
- Look at Single Post Description or the equivalent field.
A template like %excerpt% works only if the post has an excerpt or content Rank Math can trim. For pages built entirely with a page builder, the auto-generated excerpt can come out blank or odd. Writing a manual description per page avoids the problem.
Is the homepage description set in the right place?
Your homepage description comes from Rank Math > Titles & Meta > Homepage when the front page shows your latest posts, but from the page itself when you use a static front page.
This trips up many site owners. Go to Settings > Reading and check the Your homepage displays option.
- Your latest posts: set the description under Rank Math > Titles & Meta > Homepage.
- A static page: edit that page and set its description in the Rank Math panel. The Homepage tab settings may be hidden or ignored.
The same logic applies to your blog page when you use a static front page. Edit the page you assigned as the Posts page.
What about category, tag and archive descriptions?
Archive pages use the descriptions set in Rank Math > Titles & Meta for each taxonomy, or the description you enter when editing a single category or tag.
Go to Posts > Categories, click Edit on a category, and scroll to the Rank Math box. Fill in the description there.
If the archive is set to noindex in Rank Math, Google will not show it in results at all. That is fine for thin tag pages. Our guide on handling category and tag pages for SEO explains when to index them.
What should you do if nothing above works?
Update Rank Math, test with other plugins deactivated, and check whether custom code filters the description, since a developer filter can silently replace what you type.
Final checks:
- Update Rank Math from the WordPress plugin directory or your dashboard.
- Run a conflict test. Deactivate other plugins on a staging copy and recheck the source.
- Search for filters. Code using the
rank_math/frontend/descriptionfilter in functions files or snippet plugins can change the output. - Check the Rank Math status page. Under Rank Math > Status & Tools, look for warnings.
If you find the tag in the source and it is correct, the remaining issue is Google's choice. Keep the description accurate and unique, and give it time.
Frequently asked questions
Why does Google show a different description than Rank Math?
Google chooses its own snippet when it believes other text on the page better matches the search. This happens often and is not a Rank Math fault. Write an accurate, unique description, and Google is more likely to use it for relevant searches.
How long does it take for a new meta description to appear in Google?
It depends on when Google recrawls the page. That can take a few days or several weeks. Requesting indexing through the URL Inspection tool in Search Console can speed it up, but there is no guaranteed timeframe.
Can two SEO plugins cause the meta description to fail?
Yes. Two SEO plugins can each print a description tag, leaving duplicates. Search engines may pick the wrong one. Keep only Rank Math active for SEO and turn off any SEO fields built into your theme.
Why is my homepage description not changing in Rank Math?
If your homepage is a static page, Rank Math uses the description set on that page, not the Homepage tab in Titles & Meta. Edit the page assigned as your homepage and change the description in its Rank Math panel.
What length should a Rank Math meta description be?
Aim for roughly 120 to 160 characters. Rank Math shows a counter while you type. Shorter descriptions can look thin, and longer ones may be cut off in search results, though length alone will not stop Google from rewriting it.
Sources
- Control your snippets in search results Google Search Central
- URL Inspection tool Search Console Help
- Rank Math SEO plugin WordPress.org
- Standard metadata names MDN Web Docs
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


