Some users have reported that pages suddenly show 404s where diagrams should be displayed. We are not sure why this is happening, but we are investigating.

No data is lost when this happens. The way displays diagrams on a page is a macro is added to that page with an attribute specifying the name of the diagram as an attachment on that page. What we're seeing is the attachments are somehow being moved to other pages so the link is lost. To recover:

  • You need to determine the name of the attachment. For each diagram on a page there is one or more missing diagram, you need to view the page source. This is the underlying format Confluence uses to describe a page. This can be shown via the top-right "..." menu -> "View Storage Format":

Note that you need to be a Confluence admin to have this option. The resulting output will contain one or more drawio macros:

<p><ac:structured-macro ac:name="drawio" ac:schema-version="1" ac:macro-id="96e2d781-e0ba-4bcf-9b9a-c96af194082e"><ac:parameter ac:name="baseUrl"></ac:parameter><ac:parameter ac:name="diagramName">test</ac:parameter><ac:parameter ac:name="width">121</ac:parameter><ac:parameter ac:name="zoom">1</ac:parameter><ac:parameter ac:name="pageId">34832395</ac:parameter><ac:parameter ac:name="lbox">1</ac:parameter><ac:parameter ac:name="height">61</ac:parameter><ac:parameter ac:name="revision">1</ac:parameter></ac:structured-macro></p>

In each macro definition you can see a "diagramName" attribute, in this case "test". Search using the Confluence-wide search field for each of these attachments. If there are multiple matches, the search site can restrict the search to only attachment types:

(Now is the time you regret calling the diagram "test"). If, in the macro description, the "revision" attribute is equal to 1, you can simply copy the attachment from the other page to the page with the macro to fix the problem.

If the revision is not 1, the easiest fix is to download the attachment from the incorrect page to your filesystem, edit the failing page, remove the incorrect macro and insert a new macro in place. When the editor loads, drag and drop the saved file into the blank editor, then save the diagram and then the page. Repeat this for other broken macros.