The placeholder node is an inline node used in template documents to provide a prompt to end users. It is meant to be replaced with some other content by the end user, and its text should provide the user with guidance on what the replacement content should be. For example, DACI and other decision-making templates can use a placeholder that prompts the user to @mention someone who will approve the decision.

When editing a document where a template provided a placeholder, the placeholder text is initially displayed slightly greyed out to distinguish it from normal user-entered content. If the user does not provide a replacement and the placeholder is still present when the document is stored, the prompt text is not shown when the content is later rendered by the document viewer.

Compatibility

Products

Confluence	Jira
⚠️1	❌

Usage

Marks

❌ N/A

Structure

type - placeholder
attrs
- text - string – not empty
- localId? – string2

Placeholder nodes only make sense in Confluence, and even there only in document templates.↩︎
The localId, when present, will typically be a random UUID. This is not enforced by the schema.↩︎