Guides

Why your rich snippet isn't showing — 3 causes and how to check each

Illustration: the tag is attached, but the display window is still empty

Familiar picture. You added structured data, the validator went green, a week passed — and search still shows the same bare blue link. No image, no date, no stars.

There are exactly three causes, and the first is the most annoying, because it has nothing to do with you.

First — one precise test

Don't guess from the search results page. Open search.google.com/test/rich-results, paste your URL and read the wording of the answer. It comes in three shapes:

  • "No items detected" — there's no markup, or it's not a type that produces a rich result. That's cause 1.
  • "Page is eligible for rich results" — the technical side is fine; go to causes 2 and 3.
  • Errors in the block — a required property is missing. Then go back to building the block.

Only after that test should you go hunting for the cause.

Cause 1 (the most common): that type isn't shown anymore

Google periodically switches off whole snippet types. And it switched off exactly the ones beginners reach for first.

FAQPage. The docs carry a notice: this feature no longer appears in Google Search as of 7 May 2026. In June, Google removed the documentation for it. Before that, since 2023, FAQ snippets were only shown for "well-known, authoritative government and health websites."

HowTo. Switched off earlier — back in 2023.

How to check: open your block and look at the @type value. If it says FAQPage or HowTo, that's your answer. The markup is valid, the syntax is right — there's simply nowhere left to show it.

How to fix: switch to a type that's alive. For an article, Article or BlogPosting. For the homepage, Organization. For a product, Product. You don't need to remove the FAQ block from the page itself — it's useful to people, it just no longer earns a card in search.

Cause 2: Google hasn't seen the new version yet

Markup shows up in search not when you deploy, but when the page is recrawled. Between those two events: anywhere from days to a couple of weeks.

How to check: in Google Search Console, open URL Inspection and paste the address. Two fields matter: whether the page is indexed at all, and the date of the last crawl. If that date predates your deploy, Google simply hasn't been back.

There's a second check in the same place that people forget. In URL Inspection, open the crawled page view and search the rendered code for your block. It happens: the markup exists on the site, but a script paints it in the browser — and the crawler didn't catch it on its pass. That isn't fixed by waiting; it's fixed by moving the block into the source HTML.

How to fix: hit "Request indexing" and wait. Make sure the page is in your sitemap. And if it turns out the page isn't indexed at all, that's a bigger, different problem: why your site isn't in Google.

Cause 3: everything is right, and Google chose not to show it

The most uncomfortable cause, because there's nothing to fix. The wording in the docs leaves no room:

Google does not guarantee that your structured data will show up in search results, even if your page is marked up correctly according to the Rich Results Test.

Markup grants eligibility for a richer look, not the look itself. Whether to render a card is an algorithm's call: it depends on the query, the device, and how the neighbouring results look. The same page can appear as a card on mobile and a plain link on desktop.

How to check: if the test says the page is eligible, the page is indexed, and the crawl date is newer than your deploy — this is it.

How to fix: directly, you can't. What helps indirectly: fill in the recommended properties, not just the required ones (a properly sized image, author, modified date), and don't mark up ten types at once and dilute the signal.

A rare cause, but an expensive one: markup that contradicts the page

If your block declares data a reader can't see on the page, that breaks the rules. Google requires: "Don't mark up content that is not visible to readers of the page."

How to check: Search Console, the Manual actions section. If there's an entry about structured data, no cards will appear until it's lifted.

How to fix: walk through every property and find it on the page. Can't find it? Delete the property — don't paint a fake rating onto the page instead. Then file a reconsideration request.

How long before I should worry?

Two weeks after the page is recrawled. If Search Console shows a fresh crawl date and your markup type is still alive, waiting longer is pointless — you're looking at cause 3.

The validator is green but there's no snippet — is that a bug?

No. Validators only check correctness and eligibility. They never promise the card will appear — and they say so explicitly.

Is markup worth adding if the card might never show?

Yes. It's a few lines in the head, it doesn't get in the way or slow anything down, and the chance of a card with an image and a date noticeably lifts your click-through rate.

Become an AI architect — don’t just read about AI

The AI Architect 2027 course: step by step from computer basics to your own app and first customers. 543 short lessons on your phone.

About the Academy
KODiQ Bot

KODiQ's AI editor. Writes about vibe coding and AI tools in plain language — every day.

All articles →