Skip to content
Logo LogoThe AT Protocol SDK
Quickstart Guides Examples Custom lexicons Models Changelog
Logo LogoThe AT Protocol SDK
Quickstart Guides Examples Custom lexicons Models Changelog

🚀 Getting started

  • Installation
  • Quickstart

📚 Guides

  • Guides
    • Concepts
    • Authentication
    • Async
    • Posting
    • Reading
    • Social graph
    • Notifications
    • Direct messages
    • Records and repositories
    • Working with models
    • String formats
    • Resolving identities
    • Firehose
    • Jetstream
    • Error handling
    • Proxies and labelers
    • HTTP and transport
    • Building a feed generator

💡 Examples

  • Examples
    • Basics
    • Advanced usage
    • Firehose
    • Jetstream

🛠 CLI & code generation

  • The atp CLI
    • Custom lexicons
    • Code generator reference

🎛 Clients

  • Client (API)
    • Clients
      • Client
      • Raw Client
      • Base Client
      • Client method mixins
      • HTTP Client
    • Namespace
    • Utils
      • Text Builder (rich text)

📖 Models

  • Lexicons
    • app
      • bsky
        • actor
        • ageassurance
        • bookmark
        • contact
        • draft
        • embed
        • feed
        • graph
        • labeler
        • notification
        • richtext
        • unspecced
        • video
    • chat
      • bsky
        • actor
        • convo
        • embed
        • group
        • moderation
        • notification
    • com
      • atproto
        • admin
        • identity
        • label
        • lexicon
        • moderation
        • repo
        • server
        • sync
        • temp
      • germnetwork
        • declaration
    • internal
      • bsky
        • actor
    • network
      • bsky
        • jetstream
    • site
      • standard
        • graph
        • theme
        • document
        • publication
    • tools
      • ozone
        • communication
        • hosting
        • moderation
        • queue
        • report
        • safelink
        • server
        • set
        • setting
        • signature
        • team
        • verification
  • Core
    • base
    • blob_ref
    • common
    • dot_dict
    • languages
    • models_loader
    • record_registry
    • string_formats
    • type_conversion
    • unknown_type
    • unknown_union
    • utils

📡 Firehose & Jetstream

  • Firehose (data streaming)
    • Frame models
  • Jetstream (data streaming)
    • Frame models
    • Archive replay
  • Subscription
    • Subscription client
    • Frame models
    • Websocket client

🧱 Advanced

  • Core
    • NSID (NameSpaced ID)
    • CID decoder
    • AT URI Scheme
    • CAR reader
    • DAG-CBOR
    • DID Document
  • Identity (DID and Handle resolvers)
    • ID Resolver
    • Handle Resolver
    • DID Resolver
    • Cache
    • AT Protocol Data
  • Crypto
    • DID
    • Multibase
    • Verify signature
  • Server
    • Auth
  • Lexicon
    • Parser
    • Models
  • Exceptions

🛠 Development

  • Change Log
  • Security Policy
  • Licence

🔗 Project Links

  • GitHub
  • PyPI
  • Author
  • AT Protocol Docs
  • Bluesky Docs
  • Discord Bluesky API
The AT Protocol SDK
/
Lexicons
/
app
/
app.bsky
/
app.bsky.embed
/
app.bsky.embed.gallery

app.bsky.embed.gallery

Gallery.

class atproto_client.models.app.bsky.embed.gallery.Main

Bases: ModelBase

Definition model for app.bsky.embed.gallery.

field items: List[models.AppBskyEmbedGallery.Image | DotDict] [Required]

The schema-level maxLength of 20 is a future-proof ceiling. Clients should currently enforce a soft limit of 10 items in authoring UIs. The media items in the gallery. Each item may be of a different type, but all types must be supported by the client.

Constraints:
  • max_length = 20

class atproto_client.models.app.bsky.embed.gallery.Image

Bases: ModelBase

Definition model for app.bsky.embed.gallery.

field alt: str [Required]

Alt text description of the image, for accessibility.

field aspect_ratio: models.AppBskyEmbedDefs.AspectRatio [Required]

Aspect ratio.

field image: BlobRef [Required]

Image.

class atproto_client.models.app.bsky.embed.gallery.View

Bases: ModelBase

Definition model for app.bsky.embed.gallery.

field items: List[models.AppBskyEmbedGallery.ViewImage | DotDict] [Required]

Items.

class atproto_client.models.app.bsky.embed.gallery.ViewImage

Bases: ModelBase

Definition model for app.bsky.embed.gallery.

field alt: str [Required]

Alt text description of the image, for accessibility.

field aspect_ratio: models.AppBskyEmbedDefs.AspectRatio [Required]

Aspect ratio.

field fullsize: Uri [Required]

Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View.

field thumbnail: Uri [Required]

Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.

app.bsky.embed.external
app.bsky.embed.getEmbedExternalView

On this page

  • Main
    • Main.items
  • Image
    • Image.alt
    • Image.aspect_ratio
    • Image.image
  • View
    • View.items
  • ViewImage
    • ViewImage.alt
    • ViewImage.aspect_ratio
    • ViewImage.fullsize
    • ViewImage.thumbnail

© 2023-2026 Ilya (Marshal) 🦁