Skip to content

Composition Block Type Extension

Canonical../StructureDefinition/composition-block-type
Statusdraft · 1.26.0
BaseExtension (constraint)
ContextComposition.section (element)
SourceFSH · JSON

How to render this section -- the section's RENDER KIND, not the tool that produced it.

Overview

A code from note-block-types, bound extensible: where this specification names a kind, use its code; where an editor ships a kind the guide has not named yet, a code outside the set is conformant. Written on every structured section, whatever its kind -- no kind is a default that may be left implied, and none has standing the others do not.

A section carrying NO such extension predates it, and is read as text. That is what lets every note filed before block authoring existed -- four-section SOAP notes among them -- open with no migration. It is tolerance for legacy data rather than a default new data may rely on, so the branch is retirable once no untyped section remains.

A kind you do not recognise must be kept, not rewritten. A client whose vocabulary is behind the writer's has no widget for such a section and renders it as text -- correct, because the narrative is authoritative. It MUST still write the unrecognised code back unchanged. Rendering as text is a display decision; storing text in its place is data loss, and leaves the record asserting that a specialised block was prose. No binding can enforce this, which is why it is stated here.

FIRST PASS. This extension arrived with its first consumer rather than from a modelling pass, and block authoring is expected to grow around it: kinds join note-block-types as they ship, and the surface may widen as it does. The canonical is settled and will not be renamed. It moved to this guide's base before the first note carrying it was filed, which was the only moment that move was free; published canonical URLs are forever. What may still change is what the vocabulary holds, not where this extension lives.

Terminology bindings

Path Strength Value set
Extension.value[x] extensible Note Block Types