Skip to content

UnexpandedReference

A reference not resolved in this response: fetch it (resolveReference) or request a deeper resolve.

  • ReferenceBase

optional adapter?: AdapterDescriptor

ReferenceBase.adapter


optional content?: undefined


optional contextualValues?: ContentDocument

The edge’s own values, overlaid on the target’s stored defaults — by the server at resolve ≥ 1, or by applyContextualOverlay under the normalized strategy.

ReferenceBase.contextualValues


optional contract?: EntityDescriptor

Absent only on a bare embed reference authored without one — every top-level descriptor carries it.

ReferenceBase.contract


key: string

ReferenceBase.key


optional paths?: ComponentPathEntry[]

Where the referenced Component lives, when the read asked for it (referencePaths: true) — one {siteRootNodeId, path} per live published node whose root Presentation payload binds it, exactly the rule and value listComponents({ paths: true }) reports for an item. [] means the target is bound at no live node (a fragment, or a page not yet placed); the member being absent means the read did not ask. Relative paths — pick one for your site with pathForSite.

Present on an unexpanded descriptor too, which is what lets a resolve: 0 read build navigation. Always absent on a category descriptor, whose own path means something else.

ReferenceBase.paths


optional preview?: PreviewSource

Live preview only: the authoring entity behind this value. Never present on a delivery response.

ReferenceBase.preview


provider: string

ReferenceBase.provider


optional unresolvable?: undefined