Skip to main content

site.standard.document

#main​

Properties​

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

Use com.atproto.repo.createRecord to create a record.

PropertyTypeKnown ValuesRequiredDescription
pathstring-❌Combine with site or publication url to construct a canonical URL to the document. Prepend with a leading slash.
sitestring (uri)-✅Points to a publication record (at://) or a publication url (https://) for loose documents. Avoid trailing slashes.
tagsarray of string-❌Array of strings used to tag or categorize the document. Avoid prepending tags with hashtags.
linksunion of
-❌-
titlestring-✅Title of the document.
labelsunion of
com.atproto.label.defs#selfLabels
-❌-
contentunion of
-❌-
updatedAtstring (datetime)-❌Timestamp of the documents last edit.
coverImageblob-❌Image to used for thumbnail or cover image. Less than 1MB is size.
bskyPostRefcom.atproto.repo.strongRef-❌-
descriptionstring-❌A brief description or excerpt from the document.
publishedAtstring (datetime)-✅Timestamp of the documents publish time.
textContentstring-❌Plaintext representation of the documents contents. Should not contain markdown or other formatting.
contributorsarray of #contributor-❌-

Output​

PropertyTypeKnown ValuesRequiredDescription
refcom.atproto.repo.strongRef-✅-

#contributor​

PropertyTypeKnown ValuesRequiredDescription
didstring (did)-✅-
rolestring-❌-
displayNamestring-❌-