# community.lexicon.media.book.review

> A review or rating of a book. Separate record keys allow multiple reviews of the same book, including rereads.

- Kind: record
- Record key: tid
- Authority: book.media.lexicon.community
- Lexicon: 1
- Published by [lexicons.lexicon.community](https://lexicon.garden/identity/did:plc:mtr7qrqtcyseedx3jyr5o7db), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:mtr7qrqtcyseedx3jyr5o7db/community.lexicon.media.book.review)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:mtr7qrqtcyseedx3jyr5o7db/community.lexicon.media.book.review/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:mtr7qrqtcyseedx3jyr5o7db/community.lexicon.media.book.review/analytics)

## Record (`community.lexicon.media.book.review`)

Type: record · key tid

### Properties

- `content` (union): Optional client-specific rich content, using the same open-union shape as site.standard.document.content. Each content object must include a $type identifying its format. A written review must also supply its plain-text textContent fallback.
  - One of: 
- `createdAt` (string · datetime, required): Time this review was created.
- `flags` (ref)
  - Reference: `#flags`
- `rating` (integer): Rating on a 1-20 scale; divide by four for a five-star display.
  - Constraints: minimum: 1, maximum: 20
- `subject` (ref, required)
  - Reference: `community.lexicon.media.book.defs#editionRef`
- `subjectRecord` (string · at-uri): Optional AT-URI to an edition record for enrichment; subject.identifiers remain the matching mechanism.
- `textContent` (string): Plain-text review, without Markdown. At least one of rating or nonempty textContent must be supplied. Rich content alone does not satisfy this requirement.
  - Constraints: minLength: 1

## #flags (`community.lexicon.media.book.review#flags`)

Type: object

Optional review presentation flags.

### Properties

- `spoilers` (boolean): Whether the review contains spoilers.

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "flags": {
      "description": "Optional review presentation flags.",
      "properties": {
        "spoilers": {
          "description": "Whether the review contains spoilers.",
          "type": "boolean"
        }
      },
      "required": [],
      "type": "object"
    },
    "main": {
      "description": "A review or rating of a book. Separate record keys allow multiple reviews of the same book, including rereads.",
      "key": "tid",
      "record": {
        "description": "A self-contained review. At least one of rating or nonempty textContent is required.",
        "properties": {
          "content": {
            "description": "Optional client-specific rich content, using the same open-union shape as site.standard.document.content. Each content object must include a $type identifying its format. A written review must also supply its plain-text textContent fallback.",
            "refs": [],
            "type": "union"
          },
          "createdAt": {
            "description": "Time this review was created.",
            "format": "datetime",
            "type": "string"
          },
          "flags": {
            "ref": "#flags",
            "type": "ref"
          },
          "rating": {
            "description": "Rating on a 1-20 scale; divide by four for a five-star display.",
            "maximum": 20,
            "minimum": 1,
            "type": "integer"
          },
          "subject": {
            "ref": "community.lexicon.media.book.defs#editionRef",
            "type": "ref"
          },
          "subjectRecord": {
            "description": "Optional AT-URI to an edition record for enrichment; subject.identifiers remain the matching mechanism.",
            "format": "at-uri",
            "type": "string"
          },
          "textContent": {
            "description": "Plain-text review, without Markdown. At least one of rating or nonempty textContent must be supplied. Rich content alone does not satisfy this requirement.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "subject",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A portable review with an embedded book reference.",
  "id": "community.lexicon.media.book.review",
  "lexicon": 1
}
```
