Troubleshooting

I can’t see any revision records in the review panel

Most commonly, you’re in final or original mode, where revision records are hidden. Switch to:

• final-markup or original-markup

to show the revision stream.

Edits don’t generate new revisions

Check these first:

• revision.enabled is true (without it, revision is not registered)
• tracking is currently turned on (can be toggled in the Review toolbar group)
• revision.defaultEnabled only controls the initial state and can be turned off later

Accept/Reject doesn’t work

Check:

• revision.allowAcceptReject is true
• the document is not read-only (document.readOnly !== true)
• the editor is currently editable (some modes may force read-only)

Authors are missing or incorrect

Make sure each client sets:

• options.user.id
• options.user.name

Export still contains revision marks

• Revision marks are part of the document content, so exports (HTML/JSON/DOCX, etc.) can include them.
• final / original are view-only modes and won’t remove marks.
• When exporting to Word, you can uncheck Export revisions in the toolbar dialog, or disable revision export with exportDocx({ exportRevisions: false }).

Finalize before exporting if you need a clean output:

editorRef.value.acceptAllRevisions()

Why are revisions incomplete in the exported Word file?

• Current Word export can directly carry text revisions and supports some common node-level revisions. More complex node revisions may be downgraded to plain content.
• Different office suites vary in how they display revision marks. If you need to verify revision results, we recommend opening the exported docx file in Microsoft Word first.