Panduan AggregateRating Schema

cara implement AggregateRating schema markup untuk star ratings di hasil pencarian, apa schema.org/AggregateRating covers vs. apa Google memerlukan untuk review snippets, dan eligibility dan spam policies.

Pertama kali diterbitkan: 27 Jun 2026 · Terakhir diperbarui: 8 Agu 2026 · Advanced
Bahasa
1 sinyal bukti di halaman ini

AggregateRating schema (schema.org/AggregateRating) marks up average dari banyak ratings atau reviews dari sebuah item, sebagai opposed untuk Review, yang marks up satu person's opinion. ini adalah biasanya nested di dalam sebuah parent jenis's aggregateRating property (Product, LocalBusiness, Recipe, dan others), yang adalah mengapa ini dapat skip itemReviewed — tetapi Google juga accepts sebuah non-nested AggregateRating itu names itemReviewed secara langsung; either cara item menjadi rated perlu sebuah name. Google's diperlukan properties untuk star rich hasil adalah ratingValue, setidaknya satu dari ratingCount atau reviewCount, dan itemReviewed (unless nested); bestRating dan worstRating adalah recommended. eligibility aturan orang mendapatkan wrong: self-serving ratings adalah ineligible untuk star fitur secara khusus pada LocalBusiness dan Organization jenis — sebuah business rating itself — tetapi Product, Recipe, Movie, dan sebagian besar lainnya didukung jenis tetap eligible untuk genuine ratings. ratingCount (semua ratings, star-hanya disertakan) dan reviewCount (orang siapa left sebuah review, dengan atau tanpa sebuah rating) adalah berbeda angka. Valid markup hanya earns star-rating eligibility, tidak peringkat, dan fake ratings dapat trigger sebuah manual tindakan.

TL;DR — AggregateRating adalah biasanya nested di dalam sebuah parent jenis’s aggregateRating property (Product, LocalBusiness, Recipe, Book, Course, Event, Movie, SoftwareApplication, dan others), yang adalah mengapa nested contoh omit itemReviewed — tetapi Google’s spec juga mendukung sebuah non-nested AggregateRating itu names itemReviewed secara langsung. Either cara, item menjadi rated perlu sebuah name. Google’s diperlukan properties untuk star rich hasil adalah ratingValue, setidaknya satu dari ratingCount/reviewCount, dan itemReviewed ketika tidak nested; bestRating/worstRating adalah recommended (essential untuk non-1–5 scales). eligibility aturan untuk mendapatkan persis right: self-serving ratings adalah ineligible untuk star fitur secara khusus pada LocalBusiness/Organization — sebuah business rating itself — sementara Product, Recipe, Movie, dan sebagian besar lainnya didukung jenis stay eligible untuk genuine ratings. ratingCount (semua ratings, star-hanya disertakan) dan reviewCount (orang siapa left sebuah review, dengan atau tanpa sebuah rating) adalah berbeda angka. Valid markup earns star eligibility, tidak peringkat, dan fabricated ratings dapat trigger sebuah structured-data manual tindakan. ini topic adalah cross-listed di bawah data terstruktur dan di bawah ecommerce SEO karena ratings markup adalah sebuah recurring ecommerce audit item.

AggregateRating vs. Review — pembedaan semuanya hinges pada

sebagian besar pesaing guides blur ini dua jenis ke satu flat requirements list. mereka’re distinct:

  • Review marks up satu reviewer’s opinion dari sebuah item — sebuah single person, sebuah single reviewRating, sebuah body dari review text.
  • AggregateRating marks up statistical average dari banyak ratings — ratingValue plus sebuah count.

banyak nyata implementations gunakan keduanya together, nested di dalam yang sama parent jenis: sebuah aggregateRating untuk overall score dan sebuah array dari review objects untuk individual opinions. Google’s guidance berjalan satu direction, tidak keduanya: jika Anda’re sudah marking up multiple individual reviews, tambahkan sebuah aggregate rating alongside them. itu tidak berarti sebuah AggregateRating pada -nya own perlu dibuat-buat Review objects untuk go dengan ini — sebuah halaman dengan hanya sebuah aggregate dan Tidak individual reviews adalah sebuah wajar, menyelesaikan implementation. jika Anda hanya remember satu hal: Review = satu opinion, AggregateRating = average dari banyak. untuk single-reviewer side, see Review schema sibling.

Nested vs. non-nested — dua valid cara untuk attach ini

AggregateRating memiliki Tidak independent meaning pada -nya own halaman, tetapi ini tidak strictly “nest it or nothing” (terjemahan) “nest ini atau tidak ada apa pun” either. Google mendukung dua shapes:

  • Nested ( umum pattern) — AggregateRating sits di dalam lainnya jenis’s aggregateRating property (Product, LocalBusiness, Recipe, dan rest dari didukung list di bawah). Karena parent jenis sudah identifies item, sebuah nested AggregateRating omits itemReviewed — tetapi parent item masih perlu sebuah name.
  • Non-nestedAggregateRating dapat juga stand pada -nya own, disediakan ini supplies itemReviewed naming hal menjadi rated. ini adalah lebih sedikit umum dalam praktik tetapi ini adalah sebuah terdokumentasi, valid path, tidak sebuah workaround.
Evidence for this claim A nested AggregateRating omits itemReviewed, but the parent item still needs its name for Google's feature. Scope: web Confidence: high · Verified: Review snippet structured data

Either shape perlu reviewed item’s name di suatu tempat — pada parent ketika nested, di dalam itemReviewed ketika tidak. host jenis Google mendukung untuk review/star rich hasil adalah sebuah finite list: Book, Course, Event, LocalBusiness, Movie, Product, Recipe, Software App, plus additional didukung nesting jenis (CreativeWorkSeason, CreativeWorkSeries, Episode, Game, MediaObject, MusicPlaylist, MusicRecording, dan Organization).

practical consequence: putting aggregateRating pada sebuah unsupported jenis tidak akan render stars bahkan jika markup validates cleanly. Validation dan rich-hasil eligibility adalah dua berbeda bars.

Google’s spec (stricter daripada bare schema.org) untuk star rich hasil. itemReviewed baris bergantung pada yang shape Anda’re menggunakan:

PropertyStatusApa ini adalah
itemRevieweddiperlukan jika non-nested; omit jika nesteditem menjadi rated. Nested di dalam sebuah parent jenis, ini adalah implied oleh nesting dan parent’s own name — set ini explicitly hanya ketika AggregateRating stands alone
ratingValuediperlukanaverage score, e.g. 4.6
ratingCount atau reviewCountSatu diperlukanSample size behind average
bestRatingRecommendedTop dari scale (defaults untuk 5)
worstRatingRecommendedBottom dari scale (defaults untuk 1)
Evidence for this claim Google requires ratingValue plus ratingCount or reviewCount for aggregate-rating review snippets, subject to the surrounding item requirements. Scope: Google Search review snippet properties; Schema.org itself permits broader uses. Confidence: high · Verified: Google: Review snippet structured data

Dua formatting aturan dari schema.org’s own usage notes itu penyebab avoidable validation failures: gunakan nyata digit characters (0–9), tidak look-alike Unicode symbols, dan gunakan period sebagai decimal separator, tidak sebuah comma. "4,6" adalah sebuah umum mistake di locales itu gunakan comma decimals.

ratingCount vs. reviewCount — sebuah nyata pembedaan

banyak guides gunakan ini interchangeably, atau shrink reviewCount down untuk hanya “written reviews.” (terjemahan) “ditulis reviews.” Google’s saat ini property definitions adalah lebih spesifik:

  • ratingCount — total angka dari ratings, including star-hanya submissions dengan Tidak accompanying review text.
  • reviewCount — angka dari orang siapa disediakan sebuah review, dengan atau tanpa sebuah accompanying rating. ini tidak strictly “written reviews only” (terjemahan) “ditulis reviews hanya” — ini adalah keyed untuk orang siapa reviewed, apakah atau tidak mereka juga left sebuah numeric rating.

dalam praktik, pada sebagian besar rating/review platforms ini masih land sebagai berbeda angka, karena tidak everyone siapa leaves sebuah star rating menulis sebuah review dan tidak everyone siapa menulis sebuah review attaches sebuah star. sebuah store mungkin tampilkan 4,6 stars dari sebuah ratingCount dari 1 200, di mana 340 orang (reviewCount) sebenarnya left review text. Map definitions di atas onto namun Anda own platform separates “rated” (terjemahan) “rated” dari “reviewed” (terjemahan) “reviewed” alih-alih assuming situs’s rating/review split matches ini contoh persis. Google memerlukan setidaknya satu dari dua properties; supply satu itu matches apa Anda platform sebenarnya tracks, dan jangan inflate either untuk sebuah angka Anda halaman dapat’t mendukung.

bestRating / worstRating — sertakan them off default scale

Google assumes sebuah 1–5 scale ketika ini adalah absent. jika Anda rate pada 1–10, out dari 100, atau apa pun non-default range, Anda harus set bestRating/worstRating atau Google dapat misread scale — sebuah 9.2 pada sebuah 10-poin scale, left unqualified, mendapatkan interpreted sebagai 9,2 out dari 5, yang adalah nonsensical.

self-serving reviews aturan — scoped precisely

ini adalah single sebagian besar-mangled poin di topic, so I’ll state ini persis.

Google’s wording: “Jika itu entity itu menjadi reviewed controls itu reviews tentang itself, mereka halaman itu gunakan LocalBusiness atau any other jenis dari Organization structured data adalah ineligible untuk star review feature.” (terjemahan) “jika entity itu’s menjadi reviewed controls reviews tentang itself, mereka halaman itu gunakan LocalBusiness atau apa pun lainnya jenis dari Organization data terstruktur adalah ineligible untuk star review fitur.” Baca cakupan dengan hati-hati — ini names LocalBusiness dan Organization (dan mereka subtypes). ini adalah tentang sebuah business rating itself sebagai sebuah business. Evidence for this claim Google requires ratings represented in structured data to be visible to users and prohibits misleading or fabricated review markup. Scope: Google Search structured-data and review snippet policies; violations can remove feature eligibility. Confidence: high · Verified: Google: Review snippet structured data

ini melakukan tidak apply untuk Product. sebuah webshop dapat legitimately tampilkan star ratings pada -nya own product halaman — itu’s average dari genuine customer ratings dari sebuah product ini sells, tidak business rating itself. Recipe, Movie, Book, SoftwareApplication, dan rest dari didukung list stay eligible too, subject untuk ratings menjadi genuine.

ini aturan dates untuk sebuah September 2019 Google policy perubahan (“Membuat Review Rich Hasil lebih helpful” (terjemahan) “membuat Review Rich hasil lebih helpful”), yang introduced “self-serving” (terjemahan) “self-serving” framing — including reviews dari Anda own business embedded secara langsung atau pulled di melalui sebuah ketiga-party widget. (I’m paraphrasing reasoning dari itu announcement alih-alih quoting ini; saat ini, citable statement dari aturan adalah Review snippet documentation quoted di atas.) upshot: sebuah ketiga-party review widget pada Anda own LocalBusiness/ Organization halaman adalah masih self-serving dan masih ineligible untuk stars.

Organization adalah persis mengapa Organization schema sibling adalah relevant di sini — ini adalah satu dari dua host jenis di mana self-hosted ratings tidak akan earn stars.

Genuine ratings hanya — spam dan manual-tindakan policy

Dua flat aturan dari Google’s guidance:

  • jangan aggregate dari lainnya situs. Google: “jangan aggregate reviews atau ratings dari other websites.” (terjemahan) “jangan aggregate reviews atau ratings dari lainnya situs web.” Scraping ratings dari elsewhere ke Anda own markup adalah out.
  • Ratings harus menjadi dari pengguna nyata. Google’s structured-data policies frame genuine ratings sebagai enforced, tidak aspirational — -nya recipe-spesifik contoh notes itu “reviews or ratings not by actual users may result in manual action.” (terjemahan) “reviews atau ratings tidak oleh sebenarnya pengguna dapat hasil di manual tindakan.” itu principle generalizes untuk reviews policy di seluruh jenis.

sebuah structured-data manual tindakan untuk misleading atau fake ratings menghapus rich-hasil eligibility untuk halaman. ini adalah enforced, tidak theoretical. juga membuat review konten genuinely present pada halaman — Google expects marked-up ratings untuk menjadi readily tersedia untuk pengguna pada yang sama halaman, tentang sebuah spesifik item, tidak sebuah category atau sebuah list.

Di mana AggregateRating sits di wider picture

Like semua data terstruktur, AggregateRating memengaruhi rich-hasil eligibility, tidak peringkat — lebih luas Schema Markup dan data terstruktur hubs membuat itu case di penuh, so I tidak akan re-litigate ini di sini. aggregateRating adalah sebuah recommended property pada Product (paling umum dunia nyata host) dan pada ProductGroup untuk variant-tingkat rating rollups — keduanya natural berikutnya membaca. gunakan JSON-LD; ini adalah Google’s recommended format dan satu setiap contoh di ini artikel menggunakan.

Bing dan lainnya mesin: schema.org adalah sebuah joint Google/Microsoft/Yahoo/Yandex vocabulary, dan Bing’s umum structured-data documentation mengonfirmasi ini membaca schema.org/JSON-LD markup. Apa tidak saat ini verifiable terhadap pertama-party Microsoft documentation adalah sebuah jenis-spesifik claim dari parity dengan Google’s AggregateRating requirements — Bing publishes Tidak comparable per-jenis diperlukan/recommended breakdown dan Tidak self-serving-reviews policy documentation cara Google melakukan, dan -nya rich-hasil surface untuk ratings adalah lebih sempit dan lebih sedikit terdokumentasi. jangan assume Bing’s eligibility aturan mirror Google’s poin-untuk-poin; treat ini sebagai sebuah open pertanyaan alih-alih sebuah confirmed satu until Bing publishes -nya own AggregateRating-spesifik guidance.

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.