To find and fix structured markup that violates guidelines, identify the affected pages and fields, check that the markup matches the content and complies with the applicable guidelines, then make corrections and test again. Look beyond required fields: confirm that ratings apply to the entity being marked up and check for misleading or hidden markup. The practical tutorials referenced below date from 2015 and 2017. The focus here is on their approach to checking markup; their old tool names, interfaces, and specific rating recommendations should not be treated as current rules.
Identify the markup type first—do not mix requirements for different features
Google’s movie carousel documentation requires compliance with the carousel guidelines, Search Essentials, and general structured data guidelines. Its video documentation requires compliance with Search Essentials, general structured data guidelines, and video indexing requirements. Both warn that using markup techniques suspected of violating guidelines may result in manual action. This does not mean every field error will necessarily incur a penalty.
- Movie carousels: Check required properties, such as the movie’s name and an image that represents it. Images must also meet requirements such as being crawlable and indexable.
- Videos: In addition to general markup requirements, check the video indexing requirements. Livestreams also have their own requirements.
If you have already received a manual action notification, the 2017 Semrush article offers this approach: first identify the affected URLs and scope specified in the notification, then investigate the problem. The menu paths listed in that article should not be assumed to reflect the current interface.
Check both field contents and what the ratings refer to
The 2017 article recommends using the Structured Data Testing Tool available at the time to inspect page markup, the code containing each field, and any errors or warnings. After locating the issue, check whether the information entered matches the field’s definition. If the definition is unclear, consult Schema.org.
Also check, item by item, whether the markup matches the actual content. The article gives this example: placing an overall service rating in product markup without using reviews of the corresponding product makes the rating appear to apply to the product itself. Applying the same service rating to category pages creates a similar risk of misleading users. These examples illustrate how to identify problems; they do not establish current eligibility rules for all rating displays.
The 2015 article, which addresses manual actions for spammy structured markup, recommends removing misleading or hidden markup and checking compliance with Google’s relevant guidelines.
Test the revised code first, then check the live page
The correction process proposed in the 2017 article includes testing at two stages: before and after the changes go live.
- List the required fields and expected values, then fix the issues in a copy of the existing code.
- Test the revised code snippet before replacing the markup on the website.
- Once the changes are live, test the page again to confirm that nothing was omitted when putting the code back on the website.
Keep in mind that the testing interface mentioned in the tutorial is the version available at the time. For cases involving manual action, both the 2015 and 2017 articles mention requesting reconsideration after making corrections. Retesting and submitting a reconsideration request are separate steps. A test result alone does not confirm that a manual action has been lifted.
Structured markup: perspectives from across the web
What details should you check in image markup for movie carousels?
In addition to confirming that the image represents the movie being marked up and that its URL is crawlable and indexable, check its format, resolution, and aspect ratio. Google's documentation lists JPG, PNG, or GIF as supported formats and requires high-resolution images with a 6:9 aspect ratio. Images close to that ratio may be cropped; those that deviate too far cannot be used for this feature. These requirements apply to movie carousels and should not be applied indiscriminately to all markup types.
Are there additional considerations for livestream video markup?
If a livestream video includes BroadcastEvent markup, Google's documentation requires that the structured data contain no vulgar or potentially offensive language. This is an additional requirement for livestream markup; video structured data must still comply with the general structured data guidelines and video indexing requirements. The documentation also warns that markup techniques suspected of violating guidelines may result in manual action, but this does not mean every issue will necessarily incur a penalty.
If you cannot find the markup violation, must you remove all markup across the site and start over?
Not necessarily. A 2017 Semrush article suggests removing all schema markup from the site and starting over if the problem cannot be found. That was the article's recommendation at the time; the article alone does not establish it as a current official requirement. Before removing markup across the site, clarify the problem and its scope rather than treating this older recommendation as the only way to fix it.
References
- 使用結構化資料標記電影 | Google 搜尋中心 | Documentation | Google for Developersdevelopers.google.com — Discusses: What details should you check in image markup for movie carousels?
- 影片 (VideoObject、Clip、BroadcastEvent) 結構定義標記 | Google 搜尋中心 | Documentation | Google for Developersdevelopers.google.com — Discusses: Are there additional considerations for livestream video markup?
- How To Identify and Fix a Google Penaltywww.semrush.com · 2015-04-07T15:00:58Z — Source used in the article above.
- Aggregate Review Schema: Recovering From a Spammy Structured Markup Penaltywww.semrush.com · 2017-05-18T13:03:00Z — Discusses: If you cannot find the markup violation, must you remove all markup across the site and start over?

