# fyi.opensocial.reaction

> Published by [lexicons.opensocial.fyi](https://lexicon.garden/identity/did:plc:2gqnilpksz2e7faj3bwvo6qc)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:2gqnilpksz2e7faj3bwvo6qc/fyi.opensocial.reaction)
- [Documentation](https://lexicon.garden/lexicon/did:plc:2gqnilpksz2e7faj3bwvo6qc/fyi.opensocial.reaction/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:2gqnilpksz2e7faj3bwvo6qc/fyi.opensocial.reaction/examples)

## Definitions

### `fyi.opensocial.reaction`

**Type**: `record`

An emoji reaction to a post, in the reactor's own repo. One record per (subject, emoji) per person, keyed so that reacting again is an overwrite and unreacting is a delete. A placeholder for the shape Bluesky is expected to standardise for reactions in private spaces; until then it is read by fanning out over a group's public roster, like everything else members publish about the group.

**Key**: `any`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `createdAt` | `string` (datetime) | Yes |  |
| `emoji` | `string` | Yes | One emoji. |
| `subject` | `ref` → `com.atproto.repo.strongRef` | Yes | The post reacted to. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "An emoji reaction to a post, in the reactor's own repo. One record per (subject, emoji) per person, keyed so that reacting again is an overwrite and unreacting is a delete. A placeholder for the shape Bluesky is expected to standardise for reactions in private spaces; until then it is read by fanning out over a group's public roster, like everything else members publish about the group.",
      "key": "any",
      "record": {
        "properties": {
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "emoji": {
            "description": "One emoji.",
            "maxGraphemes": 1,
            "maxLength": 32,
            "type": "string"
          },
          "subject": {
            "description": "The post reacted to.",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          }
        },
        "required": [
          "subject",
          "emoji",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "fyi.opensocial.reaction",
  "lexicon": 1
}
```