app.bsky.embed.external

#main

A representation of some externally linked content (eg, a URL and 'card'), embedded in a Bluesky record (eg, a post).

Property	Type	Known Values	Required	Description
external	#external	-	✅	-

#external

Property	Type	Known Values	Required	Description
uri	string (uri)	-	✅	-
title	string	-	✅	-
description	string	-	✅	-
thumb	blob	-	❌	-
associatedRefs	array of com.atproto.repo.strongRef	-	❌	StrongRefs (uri+cid) of the Atmosphere records that backed this view.

#view

Property	Type	Known Values	Required	Description
external	#viewExternal	-	✅	-

#viewExternal

Property	Type	Known Values	Required	Description
uri	string (uri)	-	✅	-
title	string	-	✅	-
description	string	-	✅	-
thumb	string (uri)	-	❌	-
createdAt	string (datetime)	-	❌	When the external content was created, if available. Example: a publication date, for an article.
updatedAt	string (datetime)	-	❌	When the external content was updated, if available.
readingTime	integer	-	❌	Estimated reading time in minutes, if applicable and available.
labels	array of com.atproto.label.defs#label	-	❌	-
source	#viewExternalSource	-	❌	-
associatedRefs	array of com.atproto.repo.strongRef	-	❌	StrongRefs (uri+cid) of the Atmosphere records that backed this view.
associatedProfiles	array of app.bsky.actor.defs#profileViewBasic	-	❌	Profiles of the owners of the Atmosphere records that backed this view.

#viewExternalSource

The source of an external embed, such as a standard.site publication.

Property	Type	Known Values	Required	Description
uri	string (uri)	-	✅	URI of the source, if available. Example: the https:// URL of a site.standard.publication record.
icon	string (uri)	-	❌	Fully-qualified URL where an icon representing the source can be fetched. For example, CDN location provided by the App View.
title	string	-	✅	-
description	string	-	❌	-
theme	#viewExternalSourceTheme	-	❌	-

#viewExternalSourceTheme

The theme colors of an external source, such as a site.standard.publication. These colors may be used when rendering an embed from that source.

Property	Type	Known Values	Required	Description
backgroundRGB	#colorRGB	-	❌	-
foregroundRGB	#colorRGB	-	❌	-
accentRGB	#colorRGB	-	❌	-
accentForegroundRGB	#colorRGB	-	❌	-

#colorRGB

RGB color definition, inspired by site.standard.theme.color#rgb

Property	Type	Known Values	Required	Description
r	integer	-	✅	-
g	integer	-	✅	-
b	integer	-	✅	-

#viewArticle

Property	Type	Known Values	Required	Description
uri	string (uri)	-	✅	-
title	string	-	✅	-
description	string	-	✅	-
createdAt	string (datetime)	-	❌	-
updatedAt	string (datetime)	-	❌	-
labels	array of com.atproto.label.defs#label	-	❌	-
associatedRefs	array of com.atproto.repo.strongRef	-	❌	-
associatedProfiles	array of app.bsky.actor.defs#profileViewBasic	-	❌	-
image	string (uri)	-	❌	-
publisher	#viewArticlePublication	-	❌	-
readingTime	integer	-	❌	-
likeCount	integer	-	❌	-
likers	array of app.bsky.actor.defs#profileViewBasic	-	❌	Available profile previews. Selected deterministically by DID; not a ranking.

#viewArticlePublication

Property	Type	Known Values	Required	Description
uri	string (uri)	-	✅	-
title	string	-	✅	-
description	string	-	✅	-
createdAt	string (datetime)	-	❌	-
updatedAt	string (datetime)	-	❌	-
labels	array of com.atproto.label.defs#label	-	❌	-
associatedRefs	array of com.atproto.repo.strongRef	-	❌	-
associatedProfiles	array of app.bsky.actor.defs#profileViewBasic	-	❌	-
logo	string (uri)	-	❌	-
image	string (uri)	-	❌	-
theme	#viewArticlePublicationTheme	-	❌	-
subscriptionCount	integer	-	❌	-
subscribers	array of app.bsky.actor.defs#profileViewBasic	-	❌	Available profile previews. Selected deterministically by DID; not a ranking.

#viewArticlePublicationTheme

Property	Type	Known Values	Required	Description
background	string	-	❌	Hex color string, if available. Example: '#ffffff'.
foreground	string	-	❌	Hex color string, if available. Example: '#ffffff'.
accent	string	-	❌	Hex color string, if available. Example: '#ffffff'.
accentForeground	string	-	❌	Hex color string, if available. Example: '#ffffff'.

#viewGallery

Property	Type	Known Values	Required	Description
uri	string (uri)	-	✅	-
title	string	-	✅	-
description	string	-	✅	-
createdAt	string (datetime)	-	❌	-
updatedAt	string (datetime)	-	❌	-
labels	array of com.atproto.label.defs#label	-	❌	-
associatedRefs	array of com.atproto.repo.strongRef	-	❌	-
associatedProfiles	array of app.bsky.actor.defs#profileViewBasic	-	❌	-
items	array of union #viewGalleryImage	-	✅	The media items in the gallery. Each item may be of a different type, but all types must be supported by the client.
likeCount	integer	-	❌	-
likers	array of app.bsky.actor.defs#profileViewBasic	-	❌	Available profile previews. Selected deterministically by DID; not a ranking.

#viewGalleryImage

Property	Type	Known Values	Required	Description
thumbnail	string (uri)	-	✅	Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.
fullsize	string (uri)	-	✅	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.
alt	string	-	❌	Alt text description of the image, for accessibility.
aspectRatio	app.bsky.embed.defs#aspectRatio	-	❌	-

#viewLivestream

Property	Type	Known Values	Required	Description
uri	string (uri)	-	✅	-
title	string	-	✅	-
description	string	-	✅	-
createdAt	string (datetime)	-	❌	-
updatedAt	string (datetime)	-	❌	-
labels	array of com.atproto.label.defs#label	-	❌	-
associatedRefs	array of com.atproto.repo.strongRef	-	❌	-
associatedProfiles	array of app.bsky.actor.defs#profileViewBasic	-	❌	-
image	string (uri)	-	❌	-
active	boolean	-	✅	True if the livestream is currently active at the time this view is served, false if it has ended.
startedAt	string (datetime)	-	❌	-
endedAt	string (datetime)	-	❌	-