How to add links to diagrams in XWiki

Written by

The XWiki Team

Diagrams are an easy yet effective means to break down complex ideas and to visually represent your thoughts or company processes in an organized manner. In XWiki, there are a myriad of formats allowing you to do just that with the intuitive Diagram Application (Pro), thanks to the diagrams.net integration: from wireframes, mockups, UML, charts, BPMN, mind maps, to tree and network diagrams.

While you might be familiar with creating and editing diagrams in XWiki, you've probably stumbled across this quick guide to find out how you can add links to diagrams. We are describing below the steps you need to go through for 2 different use cases.

💡 How to create links to wiki pages from Diagrams that open in a new tab

• Select the shape or text in the diagram that you want to link.
• Click the "Link" button in the toolbar or right-click and choose "Edit Link".
• In the "Link" dialog window, choose "Browse" as the link type.
• Search for your target wiki page and select it.
• Confirm the link by clicking on "Apply."

Below, you can see how we've used the Diagram App to illustrate the steps described for creating links to wiki pages as an easy-to-follow alternative to a quick, small guide.

⚡ How to create external links from Diagrams that open in a new tab

• Select the shape or text in the diagram that you want to link.
• Click the "Link" button in the toolbar or right-click and choose "Edit Link."
• In the "Link" dialog window, choose "External" as the link type.
• Enter the full URL of the external website (e.g., "https://www.example.com").
• Confirm the link by clicking "Apply."

Now take a look at the chart below created with the Diagram App, that goes through the same steps explained above.

🎨 Looking for more things to do with the Diagram Application (Pro)?

If you're wondering how you can streamline your workflow using the Diagram App in XWiki, we have this video that can help you spark ideas. You can check out our YouTube channel for more useful tips on XWiki's apps and features, as well as on migrating from Confluence to an alternative open-source solution, so make sure to subscribe to be the first to learn about our updates through video tutorials.