About Bluesky Content
How Bluesky represents the content people post — and everything you need to understand Bluesky the app and its infrastructure services.
This docs site contains everything you need to understand Bluesky the app and Bluesky's own infrastructure services. If Bluesky were just an app and not a gateway to the AT Protocol ecosystem (also called the Atmosphere), these would be comprehensive docs.
There's lots more to discover in the Atmosphere, though, including tutorials, the atproto stack, and a developer blog. For all of that, refer to atproto.com. This site covers Bluesky Protocol Services, a Getting Started guide for new devs, and a deep dive into how content works on Bluesky.
Handling content
The pages below dig into how Bluesky represents the content people post — videos, the underlying shape of a post record, the rich-text facets that power links and mentions, and how to handle timestamps in a distributed network. The last two cover how Bluesky content travels off the app — through embeds on other sites, and intent links that hand off to the compose UI.
Uploading video
How video uploads differ from images.
Posts in-depth
A behind-the-scenes look at creating a post.
Links, mentions, rich text
How facets annotate post text.
Timestamps
Interpreting timestamps across skewed clocks.
Thread Gates
Set who can reply to a post.
Embeds
Embed posts on other sites via oEmbed.
Action intent links
Pre-populate the compose UI from other sites.