Something is missing or looks wrong

Diagrams page under Apps is empty, or is missing diagrams that definitely exist on issues

The browse page finds diagrams through a search index that is only written when a diagram attachment is added or deleted while the app is installed and licensed. Diagrams that were attached

Diagrams page is empty and every surface shows a "License Not Found" or "License expired" banner

Licensing is enforced in production. With no licence the app is replaced by the banner, and separately Jira stops delivering attachment events to the app, so the search index also stops upda

After fixing an expired licence, the Diagrams page still shows old or missing entries

While the licence was inactive, attachment events were dropped before the app was ever invoked, so the index silently fell behind. Nothing replays them.

TikZ is missing from the diagram type picker and there is no way to turn it on

TikZ is off by default in the picker's default list, and the Jira edition has no settings surface that could override that list.

Save appeared to succeed but the diagram is now missing from the issue entirely

On edit, the old attachment is deleted before the new one is uploaded, and an upload failure is not surfaced. A failed save can lose the original.

Very large diagrams do not render at all

Diagram source under 4,300 encoded characters is rendered through a GET URL; larger source is posted instead. Source too large to encode at all is dropped with only a console warning.