# Frequently asked questions The questions that come up most, each with a short answer and a link to the page that covers it properly. --- ## Comments ### Who can comment on a diagram? Anyone who can view a diagram can read its comments, but only people who can edit the diagram can add one. Everyone else sees **Only people who can edit this diagram can comment.** See [Comments on diagrams](https://help.gocapable.com/diagrams/comments-on-diagrams.html). ### Do people I @mention in a diagram comment get notified? Yes. Diagram comments are real Confluence comments, so a mention picked from the list sends Confluence's usual notification. A name typed without picking it stays plain text. See [Mention someone in a diagram comment](https://help.gocapable.com/diagrams/mention-someone-in-a-diagram-comment.html). ### Why can I not edit one of my comments? Capable only offers **Edit comment** when saving would keep the comment exactly as written. Comments with lists, tables, literal formatting characters, or two mentioned people with the same name stay read-only so nothing changes by accident. ### Can I delete a diagram comment? Not from the comments sidebar. You can edit your own comments, but there is no delete option there. --- ## Collections, templates and reuse ### Does adding a diagram to a collection change the diagram? No. The diagram stays on its page and no new version is created. Removing it, or deleting the collection, leaves the diagram untouched. See [Diagram collections](https://help.gocapable.com/diagrams/diagram-collections.html). ### Can one diagram be in more than one collection? Yes, in up to 32 collections, across space and global collections. ### Why is a diagram I just added missing from my collection? After a reload, a new member can take a few minutes to appear while Confluence's search index catches up. The diagram's **Details** panel always shows its collections straight away. See [Collection membership delay](https://help.gocapable.com/diagrams/collection-membership-delay.html). ### Where do I find diagram templates? Select **Capable** in the page byline and search in **Search capabilities**, or browse **Templates** in the Capable Diagrams catalogue. See [Find a diagram template in Confluence](https://help.gocapable.com/diagrams/find-a-diagram-template-in-confluence.html). ### Can I show the same diagram on more than one page? Yes. Insert **Diagram reference (Capable)** and pick the original diagram. Every page shows the current version when the original changes. See [Show the same diagram on several Confluence pages](https://help.gocapable.com/diagrams/show-the-same-diagram-on-several-confluence-pages.html). --- ## Languages, AI and migration ### Why is a diagram language missing from the picker? Your administrator has probably turned it off under **Available diagram libraries**. TikZ is off by default. Diagrams already drawn in a disabled language keep rendering. See [Disable a diagram language in Confluence](https://help.gocapable.com/diagrams/disable-a-diagram-language-in-confluence.html). ### How do I turn off AI in Capable Diagrams? A Confluence administrator switches off **AI integrations** on the **Features** tab of the app's settings. It applies to every user. See [Turn off AI diagramming in Confluence](https://help.gocapable.com/diagrams/turn-off-ai-diagramming-in-confluence.html). ### Can I move from draw.io for Confluence without redrawing? Yes. The migration wizard converts draw.io macros into Capable diagrams. Run **Perform verification** first; every changed page can be restored from its history. See [Migrate from draw.io to Capable Diagrams in Confluence](https://help.gocapable.com/diagrams/migrate-from-draw-io-to-capable-diagrams-in-confluence.html). ### Can I migrate Mermaid or PlantUML macros from another app? Yes. The migration assistant converts Stratus Mermaid and PlantUML macros, Avono PlantUML macros and the Just Add+ **Diagram** macro into Capable diagrams. viadee BPMN and DMN diagrams come across one at a time with **Import**. See [Migrating to Capable Diagrams](https://help.gocapable.com/diagrams/migrating-to-capable-diagrams.html). --- ## Troubleshooting ### Why is my diagram blank or not loading? Reload the page once. If the editor shows the same error, the source has a syntax problem. Very large diagrams can hit render limits, TikZ is off until an administrator turns it on, and readers who cannot see a referenced diagram's source page see nothing. See [Diagram does not render](https://help.gocapable.com/diagrams/diagram-does-not-render.html). ### Why is an icon blank in my D2 diagram? The icon's web address could not be reached when the diagram was drawn. The diagram still renders and leaves that icon blank. Host the icon somewhere public, or use a built-in shape. See [Domains we connect to](https://help.gocapable.com/diagrams/domains-we-connect-to.html). --- ## Related ### [How-to guides and FAQ](https://help.gocapable.com/diagrams/how-to-guides-and-faq.html) All the how-to guides. ### [Troubleshooting](https://help.gocapable.com/diagrams/troubleshooting.html) When something looks wrong. ### [Known issues](https://help.gocapable.com/diagrams/known-issues.html) Limitations we know about. --- _Short answers first, the detail one click away._