# Everything else Start from what you are seeing rather than from what you think is broken. Each page below names the symptom, explains why it happens, and says what to do about it. Several of these are the product working as designed, which is worth knowing before anybody raises a ticket. --- ## At a glance | **Symptom** | **Usually because** | | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Newly added Capable Diagram gadget already shows a flowchart I did not create | The gadget's stored configuration defaults to a sample Mermaid flowchart, so a blank gadget state never appears. | | Gadget diagram is out of date after someone changed it | The gadget is declared non-refreshable, so Jira does not offer a refresh interval for it. | | After editing a diagram, the attachment shows me as the author and today's date, and the old version | The attachment id, author and created date all change, and the issue's attachment history shows a delete plus an add rather than a new version. | | Add, Edit or Delete buttons are visible but clicking them does nothing | The permission check treats anything other than an explicit permission denial. Including a network error. As "allowed", so the buttons can appear for users who cannot actually change attachm | | Issue shows on the Diagrams browse page but the issue panel and the count badge show nothing (or the | Two different definitions of "is this attachment a diagram" are in use. The search index accepts a broader, case-insensitive list , while the panels, the badge and the save path accept only | | JQL filter using the diagram fields does not resolve, or a filter copied from documentation returns | The JQL field names carry a 6-character prefix derived from the app id and environment, so they differ per install and per environment. A name from one environment (or from a doc) will not e | | Diagram thumbnails on the Apps → Capable Diagrams page appear slowly, one after another | Preview content is downloaded through a deliberate throttle. At most 2 at a time, 100 ms apart. So a busy site fills in progressively. | | Choosing "Add" skips a "Choose a diagram type" step and drops me straight into an editor with a pick | The type-selection step navigates straight through to the editor and opens the library picker as an overlay. | | Visio file will not import | Only .vsdx and .vssx are accepted. Legacy .vsd, .vdx, .vss and .vsx are rejected with a message. | | Two diagrams on an issue have the same name and are hard to tell apart | The diagram title is used verbatim as the attachment filename with no de-duplication, so identical titles produce identically named attachments. | | "Ask AI about this diagram" button is described somewhere but never appears | The AI chat code is bundled but unreachable in this app. The required websocket provider is never mounted above the button's own check, so the button is always suppressed. | --- ## In this section [Newly added Capable Diagram gadget already shows a flowchart I did not createA newly added Capable Diagram gadget already shows a flowchart I did not create.](https://help.gocapable.com/jira-diagrams/newly-added-capable-diagram-gadget-already-shows-a-flowchart-i-did-not-create.html)[Gadget diagram is out of date after someone changed itA gadget diagram is out of date after someone changed it.](https://help.gocapable.com/jira-diagrams/gadget-diagram-is-out-of-date-after-someone-changed-it.html)[After editing a diagram, the attachment shows me as the author and today's date, and the old versionAfter editing a diagram, the attachment shows me as the author and today's date, and the old version is gone.](https://help.gocapable.com/jira-diagrams/after-editing-a-diagram-the-attachment-shows-me-as-the-author-and-today-s-date-and-the-old-version.html)[Add, Edit or Delete buttons are visible but clicking them does nothingAdd, Edit or Delete buttons are visible but clicking them does nothing.](https://help.gocapable.com/jira-diagrams/add-edit-or-delete-buttons-are-visible-but-clicking-them-does-nothing.html)[Issue shows on the Diagrams browse page but the issue panel and the count badge show nothing (or theAn issue shows on the Diagrams browse page but the issue panel and the count badge show nothing (or the reverse).](https://help.gocapable.com/jira-diagrams/issue-shows-on-the-diagrams-browse-page-but-the-issue-panel-and-the-count-badge-show-nothing-or-the.html)[JQL filter using the diagram fields does not resolve, or a filter copied from documentation returnsA JQL filter using the diagram fields does not resolve, or a filter copied from documentation returns an error.](https://help.gocapable.com/jira-diagrams/jql-filter-using-the-diagram-fields-does-not-resolve-or-a-filter-copied-from-documentation-returns.html)[Diagram thumbnails on the Apps → Capable Diagrams page appear slowly, one after anotherDiagram thumbnails on the Apps → Capable Diagrams page appear slowly, one after another.](https://help.gocapable.com/jira-diagrams/diagram-thumbnails-on-the-apps-capable-diagrams-page-appear-slowly-one-after-another.html)[Choosing "Add" skips a "Choose a diagram type" step and drops me straight into an editor with a pickChoosing "Add" skips a "Choose a diagram type" step and drops me straight into an editor with a picker over it.](https://help.gocapable.com/jira-diagrams/choosing-add-skips-a-choose-a-diagram-type-step-and-drops-me-straight-into-an-editor-with-a-pick.html)[Visio file will not importA Visio file will not import.](https://help.gocapable.com/jira-diagrams/visio-file-will-not-import.html)[Two diagrams on an issue have the same name and are hard to tell apartTwo diagrams on an issue have the same name and are hard to tell apart.](https://help.gocapable.com/jira-diagrams/two-diagrams-on-an-issue-have-the-same-name-and-are-hard-to-tell-apart.html)["Ask AI about this diagram" button is described somewhere but never appearsAn "Ask AI about this diagram" button is described somewhere but never appears.](https://help.gocapable.com/jira-diagrams/ask-ai-about-this-diagram-button-is-described-somewhere-but-never-appears.html) --- ## Related [TroubleshootingEvery symptom.](https://help.gocapable.com/jira-diagrams/troubleshooting.html) [ReferenceLimits and gaps.](https://help.gocapable.com/jira-diagrams/reference.html) [How it worksThe behaviour.](https://help.gocapable.com/jira-diagrams/how-it-works.html) --- _Most of these are expected behaviour._