Troubleshooting

Having issues with JsonLD.io? This guide covers common problems and their solutions.

Schema Not Appearing

Check Script Installation

Verify the script tag is properly installed:

View your page source (right-click → View Source)
Search for jsonld.io
Ensure the script is in the <head> section

<script async src="https://jsonld.io/api/jsonld/YOUR_TOKEN?format=js"></script>

Verify Token

Make sure you're using the correct token:

Go to Sites → Your Site → Settings
Copy the token from your script tag
Compare with the token in your website's HTML

Check Schema Status

Ensure your schemas are active:

Go to Sites → Your Site → Pages
Click on the page in question
Verify the schema exists and is toggled "Active"

Browser Cache

Clear your browser cache or try in an incognito window. Browsers may cache the old page without the script.

Crawler Issues

Pages Not Found

If the crawler isn't finding all your pages:

Check internal linking - Pages must be linked from your homepage or other crawled pages
Verify robots.txt - Ensure pages aren't blocked
Check for JavaScript rendering - If your site uses JavaScript to load content, some pages may not be discovered

Crawl Taking Too Long

Large sites may take longer to crawl:

Sites with 100+ pages may take 5-10 minutes
Sites with 1000+ pages may require multiple crawl sessions
Check your site's response time - slow servers delay crawling

Wrong Content Detected

If the crawler is seeing different content than you expect:

Ensure your server returns the same content for all user agents
Check for geo-blocking or IP restrictions
Verify there are no login walls on public pages

AI Generation Problems

Incorrect Schema Type

If the AI generates the wrong schema type:

Edit the schema manually to change the @type
Add clearer page headings and structure
Regenerate after improving page content

Missing Information

If schemas are missing important details:

Check if the information exists on the page
Add missing content to your page, then regenerate
Manually edit the schema to add missing properties

Generation Failed

If schema generation fails:

Check that the page is publicly accessible
Verify the page has meaningful content (not just images)
Try regenerating after a few minutes
Contact support if the issue persists

Display Issues

Rich Results Not Showing

Rich results in Google can take time:

Wait for indexing - Google needs to recrawl your pages
Verify validity - Use Google's Rich Results Test
Check eligibility - Not all schema types produce rich results
Review Google's guidelines - Ensure compliance with their policies

Schema Validation Errors

Use validation tools to check for errors:

Common validation issues:

Missing required properties - Add the required fields
Invalid URLs - Ensure all URLs are absolute and valid
Incorrect data types - Numbers should be numbers, not strings

Account & Billing

Subscription Not Active

If your schemas stopped working:

Check your subscription status in Settings → Billing
Verify your payment method is valid
Check for any failed payment notifications

Credit Limit Reached

If you've hit your monthly credit limit:

Wait for your credits to refresh next billing cycle
Upgrade to a higher plan for more credits
Focus on generating schemas for your most important pages first

Performance Issues

Slow Page Load

The JsonLD.io script is designed to be lightweight, but if you notice issues:

The script loads asynchronously and shouldn't block rendering
Check your network tab to verify script load times
Contact support if load times exceed 200ms consistently

Script Errors

If you see JavaScript errors in the console:

Check for conflicts with other scripts
Verify the script URL is correct
Try loading the script at the end of <body> instead of <head>

Still Need Help?

If you're still experiencing issues:

Check our FAQ for quick answers
Email us at [email protected]
Include your site URL and a description of the issue