Skip to main content
Skip table of contents

Maintaining Structured Data

Audience: Technical - Light

Technical depth: ★★★☆☆

After you have live structured data, you should look at the Google Search Console periodically to monitor your site for structured data issues.

For more, see:

Finding structured data on your PDPs

PDPs can have JSON-LD, microdata, both, or neither.

Locate JSON-LD in your PDP

Steps:

  1. Open your PDP in a web browser.

  2. Open your browser’s developer tools to view the page source.

  3. Search for ld+json and check for relevance by looking at the value of the @type key.

    • Emplifi aggregate rating content includes: "@type":"AggregateRating".

Locate microdata in your PDP

Steps:

  1. Open your PDP in a web browser.

  2. Open your browser’s developer tools to view the page source.

  3. Search for itemscope and look at the value of the itemtype attribute.

    • Emplifi aggregate rating content has an itemtype value of schema.org/AggregateRating. You'll also see itemprop="aggregateRating".

    • Product content has an itemtype value of schema.org/Product.

Tools for troubleshooting

Checking your site

To test your site’s product detail pages using Google's Structured Data Testing Tool:

  1. Visit a product detail page of your site that has review content.

  2. Open your browser’s developer tools to view the page source.

  3. Right-click the <html> node and select Copy > Copy Element (or similar).

  4. Open Google's Structured Data Testing Tool.

  5. Click CODE SNIPPET, paste the page source, and then click RUN TEST.

  6. When the results come back, look on the right side of the screen for any errors.

If you see errors, you may need to dig deeper into your markup to resolve structured data issues.

Error messages

These are the most common error messages related to aggregate reviews that appear in Google's Structured Data Testing Tool.

Thing is not a known valid target type for the itemReviewed property

Possible explanations:

  1. The product page doesn’t have any structured data. Emplifi is using microdata, and therefore has no context for the rating and review data.

    • Solution: Add product microdata, and nest the review data under your product data.

  2. The product page and the Emplifi review data both use microdata. But the review isn’t nested under a reviewable item.

    • Solution: Nest the review data under your product data.

  3. The product data and the Emplifi review data use different structured data formats—one uses JSON-LD and the other uses microdata. Therefore, the structured data testing tool is unable to identify the product to associate the review with.

    • Solution: Ask your Emplifi Customer Success Manager to set your Emplifi aggregate rating structured data to the same format you’re using for product data.

Learn more:
Combining Emplifi microdata with your microdata in Working with Structured Data.

One of offers or review or aggregateRating should be provided

Possible explanations:

  1. The product page doesn’t have any structured data. Emplifi is using microdata, and therefore has no context for the rating and review data.

    • Solution: Add product microdata, and nest the review data under your product data.

  2. The product page and the Emplifi review data both use microdata. But the review isn’t nested under a reviewable item.

    • Solution: Nest the review data under your product data.

  3. The product data and the Emplifi review data use different structured data formats—one uses JSON-LD and the other uses microdata. Therefore, the structured data testing tool is unable to identify the product to associate the review with.

    • Solution: Ask your Emplifi Customer Success Manager to set your Emplifi aggregate rating structured data to the same format you’re using for product data.

  4. The product JSON-LD and the aggregate rating JSON-LD are not connected.

    • Solution: Connect your JSON-LD to Emplifi's JSON-LD with the @id key. To learn more, see Combining Emplifi JSON-LD with your JSON-LD in Working with Structured Data.

Learn more:
Combining Emplifi microdata with your microdata in Working with Structured Data.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.