PARA

Schema reference

com.para.highlight.defs

experimental

Indexed highlight annotation views for public and private political reading layers.

Fields

subjectUri

at-uri

Required

Record being highlighted.

text

string

Required

Annotation body or highlighted excerpt.

start / end

integer offsets

Required

Range offsets locating the highlight inside the subject.

visibility

public | private

Required

Whether the highlight participates in public reading layers.

Metadata

Schema ID
com.para.highlight.defs
Lexicon source
lexicons/com/para/highlight/defs.json
Website source path
watx/lexicons/com/para/highlight/defs.json
Product surfaces
Highlights list, Highlight detail, Post highlight overlay

Constraints

  • `highlightView` requires subjectUri, text, range start/end, color, visibility, and createdAt.

Relationships

  • Backs list and detail highlight queries.

Lifecycle

  • Highlight records are indexed into a view shape that can be filtered by subject, creator, community, or state.

Writers

  • Backend indexing pipeline writes highlight views from highlight annotations.

Readers

  • Highlights route
  • Post highlight overlay
  • Reading and annotation surfaces

Routes

  • /highlights
  • /highlights/:highlightId
  • /profile/:name/post/:rkey/highlights

XRPC methods

  • com.para.highlight.listHighlights
  • com.para.highlight.getHighlight

Indexing and moderation

Indexing

  • Indexes subject linkage, text span offsets, and visibility state for browseable highlight views.

Moderation

  • Visibility and subject context determine whether a highlight is publicly readable or only personal.

Examples

{"highlightView":{"subjectUri":"at://did:plc:example/app.bsky.feed.post/3x","text":"Key quote","start":0,"end":44,"visibility":"public"}}