Rich Results Test
Put structured data on your page to enable special features in Google Search results, then test it with the Rich Results test.
Run the test
Submit the full URL of the page to test. The page must be publicly accessible by an anonymous user in order to test it (it cannot require auth, or be robotted against Googlebot). If your page is behind a firewall or hosted on your local machine, you can still test it by exposing a tunnel.
By code snippet
You can test an arbitrary code snippet using this tool. In the tool landing page, choose Code instead of URL for the test, then paste the code to be tested.
You can modify the code and rerun the test by clicking Run test as often as you like.
Review the results
The test shows which rich result types were found on the page, as well as any errors in, or suggestions for, your structured data.
If there are errors or warnings, expand the individual item to see details, and click the description to open the code explorer in the corresponding location. The explorer uses the rendered source code.
|Invalid JSON document||The JSON had a top-level syntax error.|
|Incorrect value type||The value specified for a property was of the wrong type. For example, you specified a string when a number or array was expected.|
|Parsing error: Missing ':'||Missing a ':' mark.|
|Parsing error: Missing ',' or '}'||Missing a ',' or closing bracket.|
|Parsing error: Missing '}' or object member name
||Missing a closing bracket or object member name.|
|Parsing error: Missing ',' or ']' in array declaration||Error parsing an array value: missing a ',' or ']' in the array declaration.|
|Unable to parse token length||For some reason, the start and end of a property or value could not be found.|
|Invalid number||Property value expected to be a number, but another value type was used.|
|Empty escape sequence in string||
A string value include an empty escape sequence character: for example:
|Bad escape sequence in string||
An invalid escape sequence used in a string value. For example:
"description" : "Some \q unknown sequence"
|Truncated Unicode character||Missing the last 6 characters in a Unicode surrogate pair.|
|Invalid Unicode character||Missing a \u token at the start of the second half of a Unicode surrogate pair.|
|Invalid Unicode escape sequence: four digits expected||A Unicode escape sequence has a syntax error: it should contain four digits.|
|Invalid Unicode escape sequence: hexadecimal digit expected||A Unicode escape sequence has a syntax error: a hexadecimal digit was expected but not provided.|
|Duplicate unique property||You provided two definitions for a unique property in your structured data object. For example, two
|Invalid top level element||A top-level item in your JSON-LD is invalid.|
|Reference to nonexistent item||An
Saving test history
Search Console saves your code and test state each time you click Run test. To save version history of your code and tests, bookmark the page URL after running a test. Test history is saved for approximately 90 days. These bookmarks are accessible by anyone.
Sharing test results
You can use the Share button to share the test results browser link with anyone; permissions are not required to view the results. Test result links are valid for approximately 90 days.
For some rich result types you can preview how the result might appear in Google Search. If your page is eligible for multiple Search result layouts, this tool will include selectors to let you view the different layouts, including layouts for desktop and mobile searches.
You can experiment with your page by changing the code and rerunning the test to generate new layouts. You can share the URL in your browser with other users to share your rendered results.
Depending on what the tool finds on the page, you can choose a result type to view and select a desktop or mobile version.
Google does not guarantee that your page will appear exactly as shown here, or that any of the views shown will be applied to your page result; Google tries to show the best result for a search request, based on the user's search history, location, and many other variables.
More structured data resources
Here are some more resources about structured data and Google Search result features:
- Structured data gallery shows the search result features supported by Google Search.
- Overview of structured data on Google for web page developers to enable these features.
Supported rich result types
This test currently supports only the following rich result types:
Unreported type errors
This tool does not currently show schema.org syntax errors. You can find a more complete list here.