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	-	✅	-

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.

Property	Type	Known Values	Required	Description
external	#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.

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	-	❌	-

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	-	❌	-

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

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