Skip to main content
Skip table of contents

Resolve "Broken document link"

This troubleshooting article provides step-by-step guidance for how to resolve the error message "Broken document link".


When attempting to manage your document page trees, you encounter the following error message in the document toolbox:

"Broken document link"

Possible Causes

The document version associated with the page tree may have been deleted by a user who had access to the document, but not to this particular page tree. Thus, the document’s reference to this page tree was deleted, but the page tree metadata still says it’s part of that document.


To start troubleshooting, follow the steps below:

  1. Navigate to one of the pages in your page tree.

  2. Click Document toolbox, and if you see the error message "Broken document link", proceed to the next step.

  3. Click Manage to open a new dialog providing more information about the issue.

  4. Click Remove link to disconnect the page tree from the document.

If the page tree needs to be re-added to the document

If the page tree was deleted from the document by mistake and needs to be re-added, follow these steps to define the page tree as a version:

  1. Navigate to the document manager

  2. Select ••• > Advanced options > Add existing page tree

  3. In the dialog, select the root page of the page tree you would like to add to the document and select Next.

  4. Re-add the version name and description and select Save.

The page tree is now a proper document version! 🎉

Alternative Solutions

If the issue persists after following the steps above, don’t hesitate to reach out to our support team for further assistance: When reaching out to us, don’t forget to provide detailed information about the problem, including the steps you've taken to reproduce, and an error json containing the error.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.