Troubleshooting

Troubleshooting

Something isn't working the way you expected? Start here. These are the most common problems and exactly how to fix them.

---

"My rich snippets aren't showing in Google"

This is the most common concern — and almost always, the schema is fine. The issue is timing and eligibility.

What to check:

1. Is the schema actually on the page?

Open the page in your browser → right-click → "View Page Source" → search for application/ld+json. If you find it, your schema is being injected. If not, the schema may not be assigned to that URL — go to Rich Snippets Manager and check.

2. Has Google crawled the page since you added the schema?

Google needs to visit the page after you created the schema. If you just installed Schemafy an hour ago, Google hasn't seen the schema yet.

Fix: Go to Google Search Console → URL Inspection → paste your page URL → click "Request Indexing".

3. Is the schema valid?

Go to Rich Snippets Manager → find the page → click Validate. Any errors here will prevent rich results.

Also test at: search.google.com/test/rich-results

4. Does the page have enough content?

Google requires the schema to accurately reflect the real content on the page. A FAQPage schema on a page with no FAQ content, or a Product schema on a page without a visible price, won't qualify for rich results.

5. Is the page indexed?

Rich results only appear for indexed pages. Check in Google Search Console → Coverage. If the page shows as "Excluded" or "Noindex", fix that first.

Timeline to expect: 3 days to 6 weeks for Google to pick up and display rich results, depending on how often your site is crawled.

---

"Rich snippets appeared and then disappeared"

Google regularly audits schema quality. If they disappeared, the most likely causes:

• Content changed: the page content no longer matches the schema. Update the schema to reflect the current content.
• Google quality check: if the schema described things not actually on the page, Google removed the rich result. Make sure schema and content match.
• Validation errors: run Rich Snippets Manager → Validate All to check.
• Schema conflict: another plugin started outputting competing schema. Go to Dashboard → check for conflict warnings.

---

"I have validation errors in Rich Snippets Manager"

Click on the error to see the specific message. The most common ones:

---

"The plugin is conflicting with Yoast / Rank Math / AIOSEO"

Go to Schemafy → Dashboard. If a conflict is detected, you'll see a banner identifying which plugin is also outputting schema.

What to do:

1. In the conflict banner, click "Suppress [plugin name] schema" — Schemafy will disable the competing schema output from the other plugin
2. Or: go to the other plugin's settings and disable its schema/structured data output manually. Keep its other features (sitemaps, redirects, breadcrumbs) — just disable the JSON-LD schema part.

Both plugins outputting the same schema type (e.g., two Article schemas on the same post) confuses Google and can cause Search Console warnings.

---

"Meta tags aren't updating after I save"

Your site likely uses a caching plugin (WP Rocket, W3 Total Cache, LiteSpeed Cache, etc.).

Fix:

1. Save your changes in Schemafy
2. Go to your caching plugin → clear all cache
3. Visit the page in a private/incognito browser window to see the non-cached version

If you're using a CDN (Cloudflare, BunnyCDN), purge the CDN cache as well.

---

"The AI Generator isn't generating anything"

Check these in order:

1. Is the page publicly accessible? The AI reads your live page. If it's in draft, password-protected, or returns a 404, the AI can't read it. Publish the page first.
2. Is the page in WordPress? The AI Generator works with pages registered in WordPress. External URLs won't work.
3. Try again. AI API calls occasionally time out. Wait 30 seconds and try once more.
4. Check your plan. The AI Generator requires the Pro plan.

---

"Schemas are assigned but not appearing on the page"

1. Go to Rich Snippets Manager → find the schema → check that the status is "Active" (not "Inactive" or "Draft")
2. Check that the URL assigned matches the exact URL of the page (including or excluding trailing slash — they need to match)
3. If you recently changed your permalink structure, the stored URL may no longer match. Re-assign the schema to the updated URL.

---

"The Gutenberg sidebar isn't showing"

1. Open a post in the WordPress editor
2. Click the three-dot menu (⋮) in the top right → click "Preferences"
3. Go to "Panels" → make sure "Schemafy" is enabled
4. If it's not listed, try deactivating and reactivating the plugin