b2KIT

Review & Rating Schema Builder

Generate AggregateRating and Review schema markup. Enter ratings, review count, and author data for star-rich results.

Tested tool guide Tested browser tools Checked August 16, 2026

What Review & Rating Schema Builder does, with a checked example

The star ratings under search results come from markup like this tool produces. You type what you know - the item being reviewed, its average score, how many reviews that average is based on, an author - and it returns schema.org JSON-LD to paste into the page. The markup is the easy half. What surprises most users: Google renders stars only when the rating is genuine, meaning real user reviews that actually appear on the page, and it treats self-serving ratings (an entity rating its own product) as spam. The tool serializes your numbers faithfully; it cannot vouch for them.

Worked example

A concrete input and expected output from the current implementation.

Input

Item name: Starlight Headlamp | Item type: Product | ratingValue: 4.8 | reviewCount: 127 | bestRating: 5

Expected output

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Starlight Headlamp",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "127",
    "bestRating": "5",
    "worstRating": "1"
  }
}

The tool nests the AggregateRating node inside the Product it was asked to describe, writes the average and count exactly as typed, and spells out bestRating and worstRating so the 1-5 scale is explicit to any parser rather than assumed.

How the result is produced

1

Binding the rating to the item

The form's core decision is nesting: AggregateRating and Review nodes are placed inside the node for the reviewed entity - Product, Service, Book, Recipe, and similar types - never as loose siblings. Search parsers read that containment to decide what the stars describe, which is why the tool asks for the item's name and type rather than treating them as cosmetic.

2

Verbatim serialization

The tool performs no averaging, rounding, or cross-checking. The ratingValue you type is emitted exactly, and reviewCount is emitted as an integer. A 5.0 average typed alongside four-star reviews is still serialized as typed; consistency between the markup, the reviews on the page, and the real-world count is entirely your responsibility.

Good uses

  • Before publishing a product or article page that already displays genuine customer reviews, so the page becomes eligible for review-snippet stars in Google.
  • Marking up a book, movie, recipe, or course page with both its aggregate score and the individual Review blocks that match the reviews shown on the page.
  • Restoring lost markup during a redesign or CMS migration, reusing the site's existing rating data instead of recapturing it by hand.

Limits and checks

  • Valid markup is not the same as eligible markup. Google requires the rating to be based on actual user reviews and treats self-serving or fake ratings as spam, which can bring a manual action. The tool will happily emit JSON-LD you are not allowed to use.
  • The count is audited in practice. A reviewCount that does not match the reviews visibly on the page undermines the signal, and Google's guidance says the aggregate must reflect real reviews on the page, not numbers borrowed from elsewhere.
  • Local-business pages no longer get these stars. Google stopped showing review-snippet stars for LocalBusiness-type pages in 2019 (desktop first, then mobile), so the markup still validates but earns nothing in Google, and other engines may render the same JSON-LD differently.

Common questions

Will this guarantee stars in my Google results?

No. The markup is necessary but not sufficient: Google shows review snippets only when genuine user reviews appear on the page, and it disqualifies self-serving reviews and local-business pages (since 2019). Run the output through Google's Rich Results Test to confirm it parses, and remember that search-result features change over time.

Can I use a 1-10 or 0-100 scale?

Schema.org allows any scale when bestRating and worstRating are explicit, so a ratingValue of 8.6 with bestRating 10 is valid schema. Google's review-snippet guidance describes the 1-5 scale its star rendering expects, so nonstandard scales are unlikely to render as stars. The tool writes whichever bounds you enter; whether Google honors them is a separate question.

References and verification

The example and behavioral notes were checked against the browser implementation. Standards and primary references below define the relevant format, formula, or platform behavior.

Related Tools