full diff

site.standard.document

standard.site +41 −0

← Back to Compare Lexicon page

From

bafyreifzalrdierm2q4yddul2dn7ei2x2znmucsejxa6aeppklecrt745q indexed 2026-02-20 20:46 UTC View this version

bafyreifylc5lfr4vqfzrwdtqm4pnfg7cbra7z4acbgikylqandzefwdeaq indexed 2026-04-19 21:11 UTC View this version

Compatibility

breaking 1 breaking change, 19 non-breaking changes.

Breaking changes (1)

RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "site.standard.document#contributor", src: "site.standard.document#contributor", tgt: "site.standard.document#contributor.did", kind: "prop", name: Some("did") }

Non-breaking changes (19)

AddedVertex AddedVertex { vertex_id: "com.atproto.label.defs#selfLabels" }
AddedVertex AddedVertex { vertex_id: "site.standard.document#contributor" }
AddedVertex AddedVertex { vertex_id: "site.standard.document#contributor.did" }
AddedVertex AddedVertex { vertex_id: "site.standard.document#contributor.displayName" }
AddedVertex AddedVertex { vertex_id: "site.standard.document#contributor.role" }
AddedVertex AddedVertex { vertex_id: "site.standard.document:body.contributors" }
AddedVertex AddedVertex { vertex_id: "site.standard.document:body.contributors:items" }
AddedVertex AddedVertex { vertex_id: "site.standard.document:body.labels" }
AddedVertex AddedVertex { vertex_id: "site.standard.document:body.labels:variant0" }
AddedVertex AddedVertex { vertex_id: "site.standard.document:body.links" }
AddedEdge AddedEdge { src: "site.standard.document#contributor", tgt: "site.standard.document#contributor.displayName", kind: "prop", name: Some("displayName") }
AddedEdge AddedEdge { src: "site.standard.document#contributor", tgt: "site.standard.document#contributor.role", kind: "prop", name: Some("role") }
AddedEdge AddedEdge { src: "site.standard.document:body", tgt: "site.standard.document:body.contributors", kind: "prop", name: Some("contributors") }
AddedEdge AddedEdge { src: "site.standard.document:body", tgt: "site.standard.document:body.labels", kind: "prop", name: Some("labels") }
AddedEdge AddedEdge { src: "site.standard.document:body", tgt: "site.standard.document:body.links", kind: "prop", name: Some("links") }
AddedEdge AddedEdge { src: "site.standard.document:body.contributors", tgt: "site.standard.document:body.contributors:items", kind: "items", name: None }
AddedEdge AddedEdge { src: "site.standard.document:body.contributors:items", tgt: "site.standard.document#contributor", kind: "ref", name: None }
AddedEdge AddedEdge { src: "site.standard.document:body.labels", tgt: "site.standard.document:body.labels:variant0", kind: "variant", name: Some("com.atproto.label.defs#selfLabels") }
AddedEdge AddedEdge { src: "site.standard.document:body.labels:variant0", tgt: "com.atproto.label.defs#selfLabels", kind: "ref", name: None }

Migration guidance

Added

AddedVertex { vertex_id: "com.atproto.label.defs#selfLabels" }
AddedVertex { vertex_id: "site.standard.document#contributor" }
AddedVertex { vertex_id: "site.standard.document#contributor.did" }
AddedVertex { vertex_id: "site.standard.document#contributor.displayName" }
AddedVertex { vertex_id: "site.standard.document#contributor.role" }
AddedVertex { vertex_id: "site.standard.document:body.contributors" }
AddedVertex { vertex_id: "site.standard.document:body.contributors:items" }
AddedVertex { vertex_id: "site.standard.document:body.labels" }
AddedVertex { vertex_id: "site.standard.document:body.labels:variant0" }
AddedVertex { vertex_id: "site.standard.document:body.links" }

Notes

Breaking: RequiredEdgeAdded { vertex_id: "site.standard.document#contributor", src: "site.standard.document#contributor", tgt: "site.standard.document#contributor.did", kind: "prop", name: Some("did") }
Non-breaking: AddedEdge { src: "site.standard.document#contributor", tgt: "site.standard.document#contributor.displayName", kind: "prop", name: Some("displayName") }
Non-breaking: AddedEdge { src: "site.standard.document#contributor", tgt: "site.standard.document#contributor.role", kind: "prop", name: Some("role") }
Non-breaking: AddedEdge { src: "site.standard.document:body", tgt: "site.standard.document:body.contributors", kind: "prop", name: Some("contributors") }
Non-breaking: AddedEdge { src: "site.standard.document:body", tgt: "site.standard.document:body.labels", kind: "prop", name: Some("labels") }
Non-breaking: AddedEdge { src: "site.standard.document:body", tgt: "site.standard.document:body.links", kind: "prop", name: Some("links") }
Non-breaking: AddedEdge { src: "site.standard.document:body.contributors", tgt: "site.standard.document:body.contributors:items", kind: "items", name: None }
Non-breaking: AddedEdge { src: "site.standard.document:body.contributors:items", tgt: "site.standard.document#contributor", kind: "ref", name: None }
Non-breaking: AddedEdge { src: "site.standard.document:body.labels", tgt: "site.standard.document:body.labels:variant0", kind: "variant", name: Some("com.atproto.label.defs#selfLabels") }
Non-breaking: AddedEdge { src: "site.standard.document:body.labels:variant0", tgt: "com.atproto.label.defs#selfLabels", kind: "ref", name: None }

Changes

11{

22 "$type": "com.atproto.lexicon.schema",

33 "defs": {

4 "contributor": {

5 "properties": {

6 "did": {

7 "format": "did",

8 "type": "string"

9 },

10 "displayName": {

11 "maxGraphemes": 100,

12 "maxLength": 1000,

13 "type": "string"

14 },

15 "role": {

16 "maxGraphemes": 100,

17 "maxLength": 1000,

18 "type": "string"

19 }

20 },

21 "required": [

22 "did"

23 ],

24 "type": "object"

25 },

426 "main": {

527

      "description": "A document record representing a published article, blog post, or other content. Documents can belong to a publication or exist independently.",

628 "key": "tid",

729 "record": {

830 "properties": {

931 "bskyPostRef": {

1032 "description": "Strong reference to a Bluesky post. Useful to keep track of comments off-platform.",

1133 "ref": "com.atproto.repo.strongRef",

1234 "type": "ref"

1335 },

1436 "content": {

1537 "closed": false,

1638

            "description": "Open union used to define the record's content. Each entry must specify a $type and may be extended with other lexicons to support additional content formats.",

1739 "refs": [],

1840 "type": "union"

1941 },

42 "contributors": {

43 "items": {

44 "ref": "#contributor",

45 "type": "ref"

46 },

47 "type": "array"

48 },

2049 "coverImage": {

2150 "accept": [

2251 "image/*"

2352 ],

2453 "description": "Image to used for thumbnail or cover image. Less than 1MB is size.",

2554 "maxSize": 1000000,

2655 "type": "blob"

2756 },

2857 "description": {

2958 "description": "A brief description or excerpt from the document.",

3059 "maxGraphemes": 3000,

3160 "maxLength": 30000,

3261 "type": "string"

3362 },

63 "labels": {

64 "description": "Self-label values for this post. Effectively content warnings.",

65 "refs": [

66 "com.atproto.label.defs#selfLabels"

67 ],

68 "type": "union"

69 },

70 "links": {

71 "description": "Array of values describing relationships between this document and external resources",

72 "refs": [],

73 "type": "union"

74 },

3475 "path": {

3576

            "description": "Combine with site or publication url to construct a canonical URL to the document. Prepend with a leading slash.",

3677 "type": "string"

3778 },

3879 "publishedAt": {

3980 "description": "Timestamp of the documents publish time.",

4081 "format": "datetime",

4182 "type": "string"

4283 },

4384 "site": {

4485

            "description": "Points to a publication record (at://) or a publication url (https://) for loose documents. Avoid trailing slashes.",

4586 "format": "uri",

4687 "type": "string"

4788 },

4889 "tags": {

4990

            "description": "Array of strings used to tag or categorize the document. Avoid prepending tags with hashtags.",

5091 "items": {

5192 "maxGraphemes": 128,

5293 "maxLength": 1280,

5394 "type": "string"

5495 },

5596 "type": "array"

5697 },

5798 "textContent": {

5899

            "description": "Plaintext representation of the documents contents. Should not contain markdown or other formatting.",

59100 "type": "string"

60101 },

61102 "title": {

62103 "description": "Title of the document.",

63104 "maxGraphemes": 500,

64105 "maxLength": 5000,

65106 "type": "string"

66107 },

67108 "updatedAt": {

68109 "description": "Timestamp of the documents last edit.",

69110 "format": "datetime",

70111 "type": "string"

71112 }

72113 },

73114 "required": [

74115 "site",

75116 "title",

76117 "publishedAt"

77118 ],

78119 "type": "object"

79120 },

80121 "type": "record"

81122 }

82123 },

83124 "id": "site.standard.document",

84125 "lexicon": 1