Structured data audit codes and fixes

Structured data audits validate the schema markup on your pages against Google’s requirements for rich results, Google News, Google Discover, and Top Stories carousels. Each audit code below identifies a specific issue, explains why it matters, and links to the official documentation. For a full overview of all available audit categories, see the Audits Overview.

Audits on `Article` structured data

No `Article` structured data found

code: articleNotFound

Google requires Article structured data to surface content in Google News, Google Discover, and Top Stories carousels. The system has detected URLs where this markup is missing. Confirm whether these URLs correspond to news articles, and if so, implement the markup following the official guidelines.

Unparseable structured data found

code: unparseableStructureDataFound

Structured data on this page could not be parsed because of a serious syntax error. This includes malformed JSON, invalid characters, or references to nonexistent items.

Article structured data found was not serializable

code: Deserializable

Found multiple markups for the same article

code: duplicateMarkup

Found markup belonging to another article

code: alienArticle

Mobile and desktop markups do not match

code: crossDeviceArticleIsDifferent

Google requires structured Article data to surface content in Google News, Google Discover, and Top Stories carousels. The system has detected inconsistencies between the structured data of your mobile version and your desktop version. This is not necessarily an error, but both versions should have matching markup whenever possible.

Mobile and AMP markups do not match

code: ampArticleIsDifferent

`author` not found in body

code: author_match

Google considers authorship as part of the E-E-A-T evaluation in its search algorithm. The author should appear in the body of the article whenever it makes sense editorially.

`author.name` not found or empty

code: author_name_notblank

name is a required property of the Author structured data type used to define the author of an Article. This property identifies the original author and allows Google to attribute authority and trustworthiness (part of E-E-A-T guidelines), which can improve appearance in organic search results.

`author` not found

code: author_notnull

`author.url` or `author.sameAs` not found

code: author_person_has_url

Authors should be uniquely identified by providing a link to a web page in the author.url or the author.sameAs property.

`author.sameAs` URL did not return an HTTP 200 response

code: author_sameAs_correct_response

The author.sameAs property exists but the response from the URL is not successful.

Apparently there is more than one name specified in `author.name`

code: author_single_name

Each author should be listed in a separate field. If the name field contains a , or a ;, it appears that two or more names have been concatenated.

`author` is an empty array

code: author_size

`author.url` URL did not return an HTTP 200 response

code: author_url_correct_response

The author.url property exists but the response from the URL is not successful.

`datePublished` later than `dateModified`

code: dateModified_after_published

datePublished represents the first publication date and dateModified represents the date of the last content change. The modification date cannot be earlier than the first publication date.

`dateModified` does not comply with ISO8601 format

code: dateModified_date_format

The dateModified property is a recommended property of the Article structured data type. It details the exact time when the article was last updated. The property must comply with ISO8601 standards or it will be ignored.

`dateModified` does not contain time

code: dateModified_datetime_format

The dateModified property should include the time component. For example, it should follow this format: 2022-12-25T18:00:00+00:00.

`dateModified` does not match the one found in meta `article:modified_time`

code: dateModified_match

The dateModified property is a recommended property of the Article structured data type. Some search engines use article:modified_time to identify when the article was last updated. Both properties must be identical to avoid conflicting signals.

`dateModified` not found

code: dateModified_notnull

The dateModified property is a recommended property of the Article structured data type. It specifies the exact time when the article was last updated.

The system has not found this property, which is not necessarily incorrect, especially if the article has not been modified.

Consider adding this property if the flagged URLs are articles that have been modified since the first publication date.

`datePublished` does not comply with ISO8601 format

code: datePublished_date_format

The datePublished property is a required property of the Article structured data type. The value must comply with ISO8601 standards or it will be ignored.

`datePublished` does not contain time

code: datePublished_datetime_format

The datePublished property should include the time component, not only the date. For example, it should follow this format: 2022-12-25T18:00:00+00:00.

`datePublished` not found

code: datePublished_notnull

The datePublished property is a required property of the Article structured data type. Make sure it is included in the URLs listed, especially those that are articles.

`headline` not found or empty

code: headline_notblank

The headline property is a required property of the Article structured data type. The system has not found this property within your structured data markup, or it is empty. Include this property, especially if the URL in question is an article.

`headline` must not exceed 110 characters

code: headline_size

The headline property is a required property of the Article structured data type. It must not exceed 110 characters. Editors should keep this limitation in mind when writing headlines. When that is not possible, the publication system should automatically trim the headline for the structured data field.

`image` not found

code: image_notnull

The image property is a required property of the Article structured data type. It defines the main image of the article and provides fundamental information to Google for displaying rich snippets in Top Stories, Google News, and Google Discover. Add this property to your Article markup.

No ImageObject or url found inside `image`

code: image_size

No url found inside `image`

code: image_url_notnull

The url property is a required property of the image structured data type, which is part of the Article type. Google uses this image in Top Stories, Google News, and Google Discover carousels. The system has not detected this property in the listed articles.

`image.url` is blank

code: image_url_notblank

The url property is a required property of the image structured data type, which is part of the Article type. Google uses this image in Top Stories, Google News, and Google Discover carousels. Make sure you include an image URL, especially if the URL is an article.

`image.url` is not a valid url

code: image_url_url_valid

The url property is a required property of the image structured data type, which is part of the Article type. Google uses this image in Top Stories, Google News, and Google Discover carousels. Invalid URLs have been detected in this property. Check for errors in the URL structure.

`image.url` does not return an image format

code: image_url_correct_format

The url property is a required property of the image structured data type, which is part of the Article type. Google uses this image in Top Stories, Google News, and Google Discover carousels. Images must be in JPG, PNG, WEBP, or GIF format. The system has detected that some images do not meet this requirement.

`image.height` not found

code: image_height_notnull

`image.width` not found

code: image_width_notnull

`image` does not match informed dimensions

code: image_matches_fetched_dimension

The image property is a required property of the Article structured data type. It defines the main image of the article and provides fundamental information to Google for rich snippets in Top Stories and Google Discover. The dimensions specified in width and height inside the image structured data do not match the actual dimensions of the image. Make sure both values contain the correct pixel dimensions.

`mainEntityOfPage` not found

code: mainEntityOfPage_notnull

The mainEntityOfPage property is a recommended property of the Article structured data type. It details the canonical URL of the article. The system has detected that you are not adding this property. Consider including it.

`mainEntityOfPage.id` not found or empty

code: mainEntityOfPage_id_notblank

`mainEntityOfPage.id` is not a valid url

code: mainEntityOfPage_id_url_valid

The mainEntityOfPage property is a recommended property of the Article structured data type. It details the canonical URL of the article. The value does not contain a valid URL. Check the format for errors.

`mainEntityOfPage` does not match `canonical` rel link

code: mainEntityOfPage_match

The mainEntityOfPage property is a recommended property of the Article structured data type. It details the canonical URL of the article. The provided URL does not match the canonical URL. Make sure this behavior is intentional.

`publisher.type` should be Organization

code: publisher_type_pattern

`publisher.logo` not found

code: publisher_logo_notnull

Google uses the logo structured data type for rich search results, primarily in Top Stories, Google News, and Google Discover. The system has detected URLs that do not include this property within the Article structured data, which could affect search traffic.

`publisher.logo` does not fit in a 600x60 px rectangle

code: publisher_logo_image_fits_in_rectangle

Google uses the logo structured data type for rich search results, primarily in Top Stories, Google News, and Google Discover. Google requires the image to fit within a rectangle of 600px wide and 60px high. The system has detected URLs where this property does not meet these requirements.

`publisher.logo` width is not 600px and height is not 60px

code: publisher_logo_image_match_width_or_height

Google uses the logo structured data type for rich search results, primarily in Top Stories, Google News, and Google Discover. Google requires the image to be either 600px wide or 60px high. The system has detected URLs where this property does not meet these requirements.

`publisher.logo` does not match informed dimensions

code: publisher_logo_matches_fetched_dimension

Google uses the logo structured data type for rich search results, primarily in Top Stories, Google News, and Google Discover. The dimensions specified in width and height inside the logo structured data do not correspond to the actual dimensions of the image. Make sure both values contain the correct pixel dimensions.

Format of `publisher.logo.url` is neither JPG

code: publisher_logo_url_correct_format

Google uses the logo structured data type for rich search results, primarily in Top Stories, Google News, and Google Discover. The logo must be in JPG, PNG, WEBP, or GIF format. The system has detected that the logo does not meet this requirement.

`publisher.logo.url` did not return an HTTP 200 response

code: publisher_logo_url_correct_response

Google uses the logo structured data type for rich search results, primarily in Top Stories, Google News, and Google Discover. Although the system detected a URL for the logo, it has an access error and does not return a valid status code.

`publisher.logo.url` is empty

code: publisher_logo_url_notblank

Google uses the logo structured data type for rich search results, primarily in Top Stories, Google News, and Google Discover. Although the system detected the property, the value is empty.

`publisher.logo.url` not found

code: publisher_logo_url_notnull

Google uses the logo structured data type for rich search results, primarily in Top Stories, Google News, and Google Discover. Although the system detected the logo property, it does not specify a URL.

`publisher.logo.url` is not a valid url

code: publisher_logo_url_url_valid

Google uses the logo structured data type for rich search results, primarily in Top Stories, Google News, and Google Discover. Although the system detected a URL for the logo, the value is not valid.

Product structured data found was not parseable

Code: product-Deserializable

Product name not found or empty

Code: product-name_notblank name is a required property of the Product structured data type. Read more

Product image not found

Code: product-image_notnull image is a required property of the Product structured data type for merchant listings. Read more

No ImageObject or URL found inside Product `image`

Code: product-image_size image is a required property of the Product structured data type for merchant listings. The property was found but no ImageObject or URL was detected inside. Read more

No `url` property found inside Product `image`

Code: product-image_url_notnull A product image needs a URL (either relative or absolute) to be displayed. The property was not found. Read more

No `url` value found inside Product `image`

Code: product-image_url_notblank A product image needs a URL (either relative or absolute) to be displayed. The property was found but without any content inside. Read more

Invalid URL inside Product `image`

Code: product-image_url_url_valid A product image needs a URL (either relative or absolute) to be displayed. The property was found but its contents do not look like a valid URL. Read more

Product image did not return an HTTP 200 response

Code: product-image_url_correct_response The system has found problems accessing a Product’s image URL. Read more

Invalid image format in Product

Code: product-image_url_correct_format A product image must be in JPG, PNG, WEBP, or GIF format. The system has detected that some of the images detailed in this property do not meet this requirement. Read more

Product `image.width` or `image.height` not found

Code: product-image_image_dimensions_present width and height are recommended properties of the ImageObject structured data type, which is part of the Product type. They have not been found with valid values. Read more

Product image does not match declared dimensions

Code: product-image_matches_fetched_dimension The dimensions specified in width and height inside the image property of Product do not match the actual image dimensions. Make sure both values contain the correct pixel dimensions. Read more

Product offer not found

Code: product-offers_notnull offers is a required property of the Product structured data type for merchant listings. Read more

Product offer does not contain a valid price

Code: product-offers_has_valid_price A product offer needs a numeric price property and a priceCurrency property with a valid ISO 4217 currency code. Some missing or invalid values have been detected. Read more

Product review does not contain an author

Code: product-review_author_notnull A product review needs an author property, which has not been found. Read more

No Person or Organization found inside Review `author`

Code: product-review_author_size author is a required property of the Review structured data type. The property was found but no Person or Organization was detected inside. Read more

Invalid Review author name length

Code: product-review_author_author_name_length The name property of a Review’s author must not be blank and has a maximum length. Read more

Product review does not contain a rating

Code: product-review_reviewRating_notnull A Review needs a reviewRating property with a rating of the product. Read more

Product review rating does not contain a value

Code: product-review_reviewRating_ratingValue_notblank A review rating needs a ratingValue property from which the numeric rating can be extracted. The property has not been found or is blank. Read more

Product review aggregate rating does not contain a count

Code: product-review_reviewRating_rating_count_present A review aggregate rating needs a ratingCount property or a reviewCount property. None of them has been found with a valid numeric value. Read more

Product aggregate rating does not contain a value

Code: product-aggregateRating_ratingValue_notblank An aggregate rating needs a ratingValue property from which the numeric rating can be extracted. The property has not been found or is blank. Read more

Product aggregate rating does not contain a count

Code: product-aggregateRating_rating_count_present A product aggregate rating needs a ratingCount property or a reviewCount property. None of them has been found with a valid numeric value. Read more

Product offer without review or aggregate rating

Code: product-has_offers_with_review_or_rating Although a Product only needs any of offers, review, and aggregateRating properties, the product snippets section of the Rich Results Test may report a warning if you provide offers without review or aggregateRating properties. Read more

Product with no offer, review, or rating

Code: product-has_any_of_offers_review_or_rating A Product needs any of offers, review, or aggregateRating properties to be eligible for Product Snippets in SERP. None of these have been found in the structured data of the products in the listed URLs. Read more

Audits on `recipe` structured data

Recipe structured data found was not parseable

Code: recipe-Deserializable

Recipe name not found or empty

Code: recipe-name_notblank name is a required property of the Recipe structured data type. Read more

Recipe image not found

Code: recipe-image_notnull image is a required property of the Recipe structured data type. Read more

No ImageObject or URL found inside recipe `image`

Code: recipe-image_size image is a required property of the Recipe structured data type. The property was found but no ImageObject or URL was detected inside. Read more

No `url` value found inside recipe `image`

Code: recipe-image_url_notblank A recipe image needs a URL (either relative or absolute) to be displayed. The property was found but without any content inside. Read more

Invalid URL inside recipe `image`

Code: recipe-image_url_url_valid A recipe image needs a URL (either relative or absolute) to be displayed. The property was found but its contents do not look like a valid URL. Read more

Recipe image did not return an HTTP 200 response

Code: recipe-image_url_correct_response The system has found problems accessing a recipe’s image URL. Read more

Invalid image format in recipe

Code: recipe-image_url_correct_format A recipe image must be in JPG, PNG, WEBP, or GIF format. The system has detected that some of the images detailed in this property do not meet this requirement. Read more

Recipe `image.width` or `image.height` not found

Code: recipe-image_image_dimensions_present width and height are recommended properties of the ImageObject structured data type, which is part of the Recipe type. They have not been found with valid values. Read more

Recipe image does not match declared dimensions

Code: recipe-image_matches_fetched_dimension The dimensions specified in width and height inside the image property of Recipe do not match the actual image dimensions. Make sure both values contain the correct pixel dimensions. Read more

The page containing the recipe does not have the noimageindex value within the content element of the meta name robots element

Code: recipe-metaRobots_match The page containing the recipe does not have the noimageindex value within the content element of the meta name robots element.

Structured data audit codes and fixes

Audits on Article structured data

No Article structured data found

Unparseable structured data found

Article structured data found was not serializable

Found multiple markups for the same article

Found markup belonging to another article

Mobile and desktop markups do not match

Mobile and AMP markups do not match

Audits on author structured data

author not found in body

author.name not found or empty

author not found

author.url or author.sameAs not found

author.sameAs URL did not return an HTTP 200 response

Apparently there is more than one name specified in author.name

author is an empty array

author.url URL did not return an HTTP 200 response

Audits on dates structured data

datePublished later than dateModified

dateModified does not comply with ISO8601 format

dateModified does not contain time

dateModified does not match the one found in meta article:modified_time

dateModified not found

datePublished does not comply with ISO8601 format

datePublished does not contain time

datePublished not found

Audits on headline structured data

headline not found or empty

headline must not exceed 110 characters

Audits on image structured data

image not found

No ImageObject or url found inside image

No url found inside image

image.url is blank

image.url is not a valid url

image.url does not return an image format

image.height not found

image.width not found

image does not match informed dimensions

Audits on mainEntityOfPage structured data

mainEntityOfPage not found

mainEntityOfPage.id not found or empty

mainEntityOfPage.id is not a valid url

mainEntityOfPage does not match canonical rel link

Audits on publisher structured data

publisher.type should be Organization

publisher.logo not found

publisher.logo does not fit in a 600x60 px rectangle

publisher.logo width is not 600px and height is not 60px

publisher.logo does not match informed dimensions

Format of publisher.logo.url is neither JPG

publisher.logo.url did not return an HTTP 200 response

publisher.logo.url is empty

publisher.logo.url not found

publisher.logo.url is not a valid url

Audits on product structured data