Source of truth for implementation is the canonical schema host:
https://schemas.meta-aiml.org/v3.0.0/. If any page text conflicts with canonical schema files, follow canonical files. Documentation home.Rating Review Format
v3.0.0
rating_review_format.json
Contract for aggregated ratings and review items.
Canonical File
URL: https://schemas.meta-aiml.org/v3.0.0/components/rating_review_format.json
Component endpoint: https://schemas.meta-aiml.org/v3.0.0/components/rating_review_format.json
Definitions
Definitions:
- AggregateRating (required: ratingValue, reviewCount)
- Review (required: reviewRating, reviewBody)
- ReviewCollectionSchema Reference Example
{
"properties": {
"reviews": {
"$ref": "https://schemas.meta-aiml.org/v3.0.0/components/rating_review_format.json#/$defs/ReviewCollection"
}
}
}If ratings change frequently, prefer storing source links/API endpoints in entity instances and fetching fresh values externally, instead of hardcoding stale rating snapshots.
Source-First Pattern (Recommended for dynamic data)
{
"properties": {
"ratingSources": [
{
"sourceType": "api",
"sourceUrl": "https://provider.example/reviews",
"format": "json",
"updateCadence": "daily"
}
]
}
}