Help Center
< All Topics

How To Fix Aggregate Rating Error In Schema Package

If you’re seeing an error or warning related to aggregateRating in your structured data testing tools like Google’s Rich Results Test or Schema.org validator, this guide will help you resolve it using the Schema Package WordPress Plugin.

✅ What Is aggregateRating?

The aggregateRating property is used to show the overall rating for an item (like a product, service, or article) based on multiple users’ ratings. It includes key fields like:

  • ratingValue
  • reviewCount or ratingCount

For example, in Google Search, this allows showing star ratings and review counts in rich snippets.

❌ Common Errors or Warnings

You might see errors or warnings like:

  • Missing field “ratingValue”
  • Missing field “reviewCount” or “ratingCount”
  • Invalid value type for aggregateRating
  • Aggregate rating must have at least one review

These usually happen when:

  • Ratings or reviews are missing.
  • Incorrect data types are entered (e.g., using text instead of number).
  • Fields are left blank or improperly mapped.

🛠️ How To Fix It Using Schema Package

Step 1: Determine Schema Type

Make sure you’re adding aggregateRating only on supported schema types like:

  • Product
  • Service
  • Course
  • LocalBusiness
  • SoftwareApplication
  • Book
  • Event

If you’re trying to use it on unsupported schema types like Article or FAQPage, the error will persist because it’s not allowed.

Step 2: Use Method 1 (Global Schema with Mapping)

  1. Go to Schema Package → Add Schema
  2. Choose a supported Schema Type (e.g., Product, Service)
  3. In the popup, click “Map Fields” next to aggregateRating
  4. Map the following fields:
    • ratingValue → Set a numeric value (e.g., 4.8)
    • reviewCount or ratingCount → Set a valid number (e.g., 132)
  5. Save the schema.

📝 Note: Ensure that these fields are either static (manually entered) or mapped from your custom fields where ratings are stored.

Step 3: Use Method 2 (Per Post/Page Custom Schema)

  1. Edit the post or page.
  2. Scroll to Schema Package Generator
  3. Choose your Schema Type and click Edit.
  4. Find aggregateRating and click Add Property.
  5. Fill in:
    • ratingValue (e.g., 4.9)
    • reviewCount or ratingCount (e.g., 120)
  6. Save and update the post.

⚠️ Avoid using strings or percentages (like “5 stars” or “95%”). Only plain numbers (like 4.5) are allowed.

🔄 Pro Tips

  • Do not fake rating values — Google may penalize if you show star ratings without actual reviews or supporting content.
  • Use real reviews or feedback if your plugin/site collects user reviews.
  • If your theme or plugin stores reviews in custom fields, use the mapping feature to dynamically link them.

✅ Validate After Fixing

After setting up aggregateRating, always test your pages using the tools below:

Paste your URL and ensure there are no errors or warnings related to aggregateRating.

🎯 Final Note

If you still see issues even after correctly entering values, check:

  • Whether the values are inside a supported schema type.
  • The data format (must be a number, not text).
  • You haven’t duplicated aggregateRating inside nested schemas incorrectly.

Need help? Contact Schema Package Support or check our Knowledge Base for advanced use cases.

Table of Contents