# tools.kryphocron.feed.postPublic

> Public-tier post. Field schema compatible with app.bsky.feed.post; consuming AppViews must include this NSID in their allowlist to index it. Substrate behavior: emit to public firehose, no audience-list consultation.

- Kind: record
- Record key: tid
- Authority: feed.kryphocron.tools
- Lexicon: 1
- Published by [lexicons.kryphocron.tools](https://lexicon.garden/identity/did:plc:femlcrrqw5ja23dlsqc6qtgy), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:femlcrrqw5ja23dlsqc6qtgy/tools.kryphocron.feed.postPublic)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:femlcrrqw5ja23dlsqc6qtgy/tools.kryphocron.feed.postPublic/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:femlcrrqw5ja23dlsqc6qtgy/tools.kryphocron.feed.postPublic/analytics)

## Record (`tools.kryphocron.feed.postPublic`)

Type: record · key tid

### Properties

- `createdAt` (string · datetime, required): Time the post was created on the client.
- `embed` (union): Optional embed (image, external link, or quoted record).
  - One of: `#embedImage`, `#embedExternal`, `#embedRecord`
- `facets` (array): Text annotations (mentions, links, tags).
  - `items` (ref)
    - Reference: `#facet`
- `reply` (ref): Optional parent and root post references.
  - Reference: `#replyRef`
- `text` (string, required): Post content.
  - Constraints: maxLength: 3000, maxGraphemes: 300

## #aspectRatio (`tools.kryphocron.feed.postPublic#aspectRatio`)

Type: object

Width and height of an image or video. Only the ratio is meaningful; units are arbitrary.

### Properties

- `height` (integer, required)
  - Constraints: minimum: 1
- `width` (integer, required)
  - Constraints: minimum: 1

## #byteSlice (`tools.kryphocron.feed.postPublic#byteSlice`)

Type: object

### Properties

- `byteEnd` (integer, required)
  - Constraints: minimum: 0
- `byteStart` (integer, required)
  - Constraints: minimum: 0

## #caption (`tools.kryphocron.feed.postPublic#caption`)

Type: object

### Properties

- `file` (blob, required)
  - Constraints: maxSize: 20000, accept: text/vtt
- `lang` (string · language, required)

## #embedExternal (`tools.kryphocron.feed.postPublic#embedExternal`)

Type: object

### Properties

- `external` (ref, required)
  - Reference: `#external`

## #embedGallery (`tools.kryphocron.feed.postPublic#embedGallery`)

Type: object

### Properties

- `items` (array, required): Gallery items. The schema ceiling of 20 is future-proofing; authoring clients should currently limit galleries to 10 items.
  - Constraints: maxLength: 20
  - `items` (union)
    - One of: `#galleryImage`

## #embedImage (`tools.kryphocron.feed.postPublic#embedImage`)

Type: object

### Properties

- `images` (array, required)
  - Constraints: maxLength: 4
  - `items` (ref)
    - Reference: `#image`

## #embedRecord (`tools.kryphocron.feed.postPublic#embedRecord`)

Type: object

### Properties

- `record` (ref, required)
  - Reference: `#strongRef`

## #embedRecordWithMedia (`tools.kryphocron.feed.postPublic#embedRecordWithMedia`)

Type: object

### Properties

- `media` (union, required)
  - One of: `#embedImage`, `#embedGallery`, `#embedVideo`, `#embedExternal`
- `record` (ref, required)
  - Reference: `#embedRecord`

## #embedVideo (`tools.kryphocron.feed.postPublic#embedVideo`)

Type: object

### Properties

- `alt` (string): Alt-text for accessibility.
- `aspectRatio` (ref)
  - Reference: `#aspectRatio`
- `captions` (array)
  - Constraints: maxLength: 20
  - `items` (ref)
    - Reference: `#caption`
- `presentation` (string): Presentation hint for clients.
  - Constraints: knownValues: default | gif
- `video` (blob, required)
  - Constraints: maxSize: 300000000, accept: video/mp4

## #external (`tools.kryphocron.feed.postPublic#external`)

Type: object

### Properties

- `description` (string, required)
- `thumb` (blob)
  - Constraints: maxSize: 1000000, accept: image/*
- `title` (string, required)
- `uri` (string · uri, required)

## #facet (`tools.kryphocron.feed.postPublic#facet`)

Type: object

### Properties

- `features` (array, required)
  - `items` (union)
    - One of: `#mention`, `#link`, `#tag`
- `index` (ref, required)
  - Reference: `#byteSlice`

## #galleryImage (`tools.kryphocron.feed.postPublic#galleryImage`)

Type: object

### Properties

- `alt` (string, required): Alt-text for accessibility.
- `aspectRatio` (ref, required)
  - Reference: `#aspectRatio`
- `image` (blob, required)
  - Constraints: maxSize: 2000000, accept: image/*

## #image (`tools.kryphocron.feed.postPublic#image`)

Type: object

### Properties

- `alt` (string, required): Alt-text for accessibility.
- `aspectRatio` (ref)
  - Reference: `#aspectRatio`
- `image` (blob, required)
  - Constraints: maxSize: 2000000, accept: image/*

## #link (`tools.kryphocron.feed.postPublic#link`)

Type: object

### Properties

- `uri` (string · uri, required)

## #mention (`tools.kryphocron.feed.postPublic#mention`)

Type: object

### Properties

- `did` (string · did, required)

## #replyRef (`tools.kryphocron.feed.postPublic#replyRef`)

Type: object

### Properties

- `parent` (ref, required)
  - Reference: `#strongRef`
- `root` (ref, required)
  - Reference: `#strongRef`

## #selfLabel (`tools.kryphocron.feed.postPublic#selfLabel`)

Type: object

### Properties

- `val` (string, required): The label value.
  - Constraints: maxLength: 128

## #selfLabels (`tools.kryphocron.feed.postPublic#selfLabels`)

Type: object

Content labels applied by the record's author.

### Properties

- `values` (array, required)
  - Constraints: maxLength: 10
  - `items` (ref)
    - Reference: `#selfLabel`

## #strongRef (`tools.kryphocron.feed.postPublic#strongRef`)

Type: object

### Properties

- `cid` (string · cid, required)
- `uri` (string · at-uri, required)

## #tag (`tools.kryphocron.feed.postPublic#tag`)

Type: object

### Properties

- `tag` (string, required)
  - Constraints: maxLength: 640, maxGraphemes: 64

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "aspectRatio": {
      "description": "Width and height of an image or video. Only the ratio is meaningful; units are arbitrary.",
      "properties": {
        "height": {
          "minimum": 1,
          "type": "integer"
        },
        "width": {
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "width",
        "height"
      ],
      "type": "object"
    },
    "byteSlice": {
      "properties": {
        "byteEnd": {
          "minimum": 0,
          "type": "integer"
        },
        "byteStart": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "byteStart",
        "byteEnd"
      ],
      "type": "object"
    },
    "caption": {
      "properties": {
        "file": {
          "accept": [
            "text/vtt"
          ],
          "maxSize": 20000,
          "type": "blob"
        },
        "lang": {
          "format": "language",
          "type": "string"
        }
      },
      "required": [
        "lang",
        "file"
      ],
      "type": "object"
    },
    "embedExternal": {
      "properties": {
        "external": {
          "ref": "#external",
          "type": "ref"
        }
      },
      "required": [
        "external"
      ],
      "type": "object"
    },
    "embedGallery": {
      "properties": {
        "items": {
          "description": "Gallery items. The schema ceiling of 20 is future-proofing; authoring clients should currently limit galleries to 10 items.",
          "items": {
            "refs": [
              "#galleryImage"
            ],
            "type": "union"
          },
          "maxLength": 20,
          "type": "array"
        }
      },
      "required": [
        "items"
      ],
      "type": "object"
    },
    "embedImage": {
      "properties": {
        "images": {
          "items": {
            "ref": "#image",
            "type": "ref"
          },
          "maxLength": 4,
          "type": "array"
        }
      },
      "required": [
        "images"
      ],
      "type": "object"
    },
    "embedRecord": {
      "properties": {
        "record": {
          "ref": "#strongRef",
          "type": "ref"
        }
      },
      "required": [
        "record"
      ],
      "type": "object"
    },
    "embedRecordWithMedia": {
      "properties": {
        "media": {
          "refs": [
            "#embedImage",
            "#embedGallery",
            "#embedVideo",
            "#embedExternal"
          ],
          "type": "union"
        },
        "record": {
          "ref": "#embedRecord",
          "type": "ref"
        }
      },
      "required": [
        "record",
        "media"
      ],
      "type": "object"
    },
    "embedVideo": {
      "properties": {
        "alt": {
          "description": "Alt-text for accessibility.",
          "type": "string"
        },
        "aspectRatio": {
          "ref": "#aspectRatio",
          "type": "ref"
        },
        "captions": {
          "items": {
            "ref": "#caption",
            "type": "ref"
          },
          "maxLength": 20,
          "type": "array"
        },
        "presentation": {
          "description": "Presentation hint for clients.",
          "knownValues": [
            "default",
            "gif"
          ],
          "type": "string"
        },
        "video": {
          "accept": [
            "video/mp4"
          ],
          "maxSize": 300000000,
          "type": "blob"
        }
      },
      "required": [
        "video"
      ],
      "type": "object"
    },
    "external": {
      "properties": {
        "description": {
          "type": "string"
        },
        "thumb": {
          "accept": [
            "image/*"
          ],
          "maxSize": 1000000,
          "type": "blob"
        },
        "title": {
          "type": "string"
        },
        "uri": {
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "uri",
        "title",
        "description"
      ],
      "type": "object"
    },
    "facet": {
      "properties": {
        "features": {
          "items": {
            "refs": [
              "#mention",
              "#link",
              "#tag"
            ],
            "type": "union"
          },
          "type": "array"
        },
        "index": {
          "ref": "#byteSlice",
          "type": "ref"
        }
      },
      "required": [
        "index",
        "features"
      ],
      "type": "object"
    },
    "galleryImage": {
      "properties": {
        "alt": {
          "description": "Alt-text for accessibility.",
          "type": "string"
        },
        "aspectRatio": {
          "ref": "#aspectRatio",
          "type": "ref"
        },
        "image": {
          "accept": [
            "image/*"
          ],
          "maxSize": 2000000,
          "type": "blob"
        }
      },
      "required": [
        "image",
        "alt",
        "aspectRatio"
      ],
      "type": "object"
    },
    "image": {
      "properties": {
        "alt": {
          "description": "Alt-text for accessibility.",
          "type": "string"
        },
        "aspectRatio": {
          "ref": "#aspectRatio",
          "type": "ref"
        },
        "image": {
          "accept": [
            "image/*"
          ],
          "maxSize": 2000000,
          "type": "blob"
        }
      },
      "required": [
        "image",
        "alt"
      ],
      "type": "object"
    },
    "link": {
      "properties": {
        "uri": {
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "uri"
      ],
      "type": "object"
    },
    "main": {
      "key": "tid",
      "record": {
        "properties": {
          "createdAt": {
            "description": "Time the post was created on the client.",
            "format": "datetime",
            "type": "string"
          },
          "embed": {
            "description": "Optional embed (image, external link, or quoted record).",
            "refs": [
              "#embedImage",
              "#embedExternal",
              "#embedRecord"
            ],
            "type": "union"
          },
          "facets": {
            "description": "Text annotations (mentions, links, tags).",
            "items": {
              "ref": "#facet",
              "type": "ref"
            },
            "type": "array"
          },
          "reply": {
            "description": "Optional parent and root post references.",
            "ref": "#replyRef",
            "type": "ref"
          },
          "text": {
            "description": "Post content.",
            "maxGraphemes": 300,
            "maxLength": 3000,
            "type": "string"
          }
        },
        "required": [
          "text",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    },
    "mention": {
      "properties": {
        "did": {
          "format": "did",
          "type": "string"
        }
      },
      "required": [
        "did"
      ],
      "type": "object"
    },
    "replyRef": {
      "properties": {
        "parent": {
          "ref": "#strongRef",
          "type": "ref"
        },
        "root": {
          "ref": "#strongRef",
          "type": "ref"
        }
      },
      "required": [
        "root",
        "parent"
      ],
      "type": "object"
    },
    "selfLabel": {
      "properties": {
        "val": {
          "description": "The label value.",
          "maxLength": 128,
          "type": "string"
        }
      },
      "required": [
        "val"
      ],
      "type": "object"
    },
    "selfLabels": {
      "description": "Content labels applied by the record's author.",
      "properties": {
        "values": {
          "items": {
            "ref": "#selfLabel",
            "type": "ref"
          },
          "maxLength": 10,
          "type": "array"
        }
      },
      "required": [
        "values"
      ],
      "type": "object"
    },
    "strongRef": {
      "properties": {
        "cid": {
          "format": "cid",
          "type": "string"
        },
        "uri": {
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "uri",
        "cid"
      ],
      "type": "object"
    },
    "tag": {
      "properties": {
        "tag": {
          "maxGraphemes": 64,
          "maxLength": 640,
          "type": "string"
        }
      },
      "required": [
        "tag"
      ],
      "type": "object"
    }
  },
  "description": "Public-tier post. Field schema compatible with app.bsky.feed.post; consuming AppViews must include this NSID in their allowlist to index it. Substrate behavior: emit to public firehose, no audience-list consultation.",
  "id": "tools.kryphocron.feed.postPublic",
  "lexicon": 1
}
```
