I can see diagrams but can't edit them
You need Edit issues permission on the issue. Ask your Jira admin, or a project admin.
An editor is missing from New
A Jira admin turned it off in Diagrams settings. Diagrams already made with it still open.
The AI button is missing, or AI says the limit is reached
- No AI button: AI is turned off in Diagrams settings.
- "This site has used all … AI generations for this month": an admin can raise Generations per month.
- "You've reached … AI generations this hour": wait, or ask an admin to raise Generations per person per hour.
- "The AI didn't return a usable diagram" or "too large to generate in one go": try a shorter or simpler request.
The draw.io editor stays blank
Your network or a browser extension is blocking diagrams.net. Allow embed.diagrams.net, app.diagrams.net and viewer.diagrams.net.
A save failed
- "Too many saves right now": wait a few seconds and save again.
- "Diagram content is too large": remove large images or split the diagram into two.
- "This diagram was changed by someone else": someone saved while you were editing. Choose Overwrite theirs, or close and reopen to see their version.
An import failed
Check the file type is in the list under Import a file and is under about 2.5 MB. An SVG must be exported from draw.io with Include a copy of my diagram.
"The image was removed from the description"
Someone deleted the diagram image from the description, so the app stopped updating it. Press Description → Add to issue description to add it again.
"Subscription inactive"
The app's license on this site has lapsed. A Jira admin can renew it in Apps → Manage apps. Your diagrams are kept in the meantime.