"The diagram could not be found"
The diagram's file was deleted or renamed, or it lives on a page you can't view (common with copied or embedded diagrams). Ask someone with access to the original page, or edit the macro to choose another diagram.
The draw.io editor or viewer doesn't load
"Could not load the diagram viewer" or a blank editor means your network or a browser extension is blocking diagrams.net. Allow embed.diagrams.net, viewer.diagrams.net and app.diagrams.net.
"New … diagrams are turned off on this site"
An admin turned that type off in Diagram types. Use another macro, or ask your admin.
I can't publish
- "You don't have permission to change attachments on this page": you need edit access and attachment permission on the page.
- "already exists on this page": choose another name.
- "Confluence is busy (rate limited)": wait a minute and try again.
AI limits
When the monthly or hourly limit is reached, an admin can raise it in Diagrams configuration. If the AI fixes an error in its own answer, that retry counts as a second generation.
A diagram is missing from Apps → Diagrams or search
Edit and publish the diagram again, or ask an admin to run Re-index.
"Subscription inactive"
The app's license on this site has lapsed. A Confluence admin can renew it in Manage apps. No diagrams are deleted, and they come back when it's renewed.