How to Check JSON-LD Structured Data on a Web Page

To check the JSON-LD on a web page, open the JSON-LD Validator, paste the page address and click "Fetch and validate JSON-LD". The result lists every problem, every item the page describes, and the JSON of each block. When the page has no problems, the summary is green.

How to check a page

1. Open the page in your browser and copy the address from the address bar.
2. Paste it into the URL field. If the address has no https://, it is added for you.
3. Click "Fetch and validate JSON-LD".
4. Read the summary above the tables. It gives the number of blocks, errors and warnings.
5. Pick a block under Source to see its JSON with line numbers.

How to read the result

• The problem table lists each error and warning. It appears only when there is a problem.
• Block is the number of the script block, counted from the top of the page.
• Location shows where the problem is, such as Product.image.
• The item table lists each item, with its type, such as Article or Product, and its name.
• Click a column header to sort a table. The buttons under each table export it as CSV or JSON.

Which problems to fix first

Errors come first in the list and have a red label. Warnings have a yellow label. An error means that something is broken, or that a required field is missing. Warnings marked "(optional)" are fields you can add when you have the data.

These messages have simple fixes.

Message	Fix
Invalid JSON	Look for a missing comma or quote, or a comma after the last value.
Missing @context, add "@context": "https://schema.org"	Add this line to the block.
Missing @type	Add a type, such as "@type": "Product".
"@Type" is not a JSON-LD keyword	Write keywords in lower case: @type.
Type "Organisation" is not a valid schema.org type	Use the exact schema.org name, here Organization.
Required attribute "image" is missing	Add the field named in the message.

When the check finds nothing or fails

"No JSON-LD script blocks were found on this page" means the HTML of the page has no JSON-LD. The check reads the page as the server sends it. JSON-LD that a script adds later, in the browser, is not found.

"Failed to fetch the page" means the site did not send the page. This also happens when the address redirects to another one, because redirects are not followed. Copy the final address from the address bar and try again.

Only the first 3 MB of a page are checked. A message tells you when a page is larger.

Fix the errors, update the page, and run the check again.