Core Concepts

Two forms of tracking

Umo Editor Next represents Track Changes in two ways:

• Text tracking: change marks applied to text ranges (insertion / deletion)
• Node tracking: change attributes (for example data-revision-type, data-revision-id) stored on certain node types to represent inserting/removing the node itself

insertion / deletion (text tracking)

• insertion: the content is newly added.
• deletion: the content is removed, but preserved as a reviewable change until finalized.

Trackable scope (node tracking)

Track Changes has two layers:

• Text tracking applies to most content that ultimately becomes text in the document (paragraphs, headings, list items, table cells, footnote content, etc.).
• Node tracking focuses on “the node itself was inserted/removed”, which is especially useful for non-text media or structural blocks.

Whether node tracking applies depends on the node meeting the “node-level revision target” condition (it has the revision attrs contract and is an atom/leaf non-text node). When applicable, inserting/removing the node is shown as a revision record and can be accepted/rejected.

Common trackable node examples:

• image / inlineImage
• video / audio
• file / iframe
• mention
• blockMath / inlineMath
• pageBreak / toc
• datetime
• echarts

These capabilities are typically not represented as node-change records:

• columns (columnContainer/column)
• hardBreak / horizontalRule (more like text editing controls)
• bookmark (a mark, not a node)
• locked (editing protection, not equivalent to node insertion/removal)

Even when node tracking is not applied, text inside those structures may still be tracked as text changes.

Markup modes (view only)

Markup modes affect how changes are displayed. They do not remove change marks from the document.

• final-markup: final content + show marks
• final: final content (hide deletions; insertions look normal)
• original-markup: original content + show marks (insertions/deletions are presented from the “original” perspective)
• original: original content (hide insertions; deletions look normal)

To permanently finalize the content, you must accept/reject changes.