Reading Time: 3 min

Do you often include your own graphics and icons in your diagrams? The new version of the diagramming tool for Confluence allows you to quickly and easily import your own libraries and use your custom Shapes. In this tutorial, we will show you how to work with custom libraries within

Open a custom library

You can open a custom library easily in the editor using the main menu:

drawio-custom-libraries-1-229x300 main menu

This opens the Libraries dialog, where you have the ability to add images to the library with drag and drop, from a URL or with a standard file browser. You can also protect the custom library by limiting editing rights.

 Using and expanding custom libraries

After the custom library has had images added to it and has been saved, it appears together with the native templates in the Library panel on the left hand side.

draw-io-custom-libraries-3-300x268 custom library in Library panel

drawio Plus Add the currently selected object from the chart into the custom library as a template.

drawio edit Edit the custom library. This opens the Library dialog.

drawio close Close this custom library – nothing will be deleted from the library.

Being able to add objects from diagrams to the library as a template is ideal for often used components. Select the desired area in your diagram and then click the plus symbol. Your selected object is now available in the custom library as a template.

View the existing custom libraries

You can see all available custom libraries by using the Open Library function in the main menu (see the first screenshot above). All custom libraries are displayed with the name and author of the library, and a preview of the contents.

drawio-auswahl-768x468 custom library selection

Custom libraries are always available within the Library panel of a diagram. When a diagram uses multiple custom libraries, all of these will be opened along with the diagram.

Your partner for

If you want to learn more, you can test for free and without obligation in a Confluence or JIRA environment. JGraph and //SEIBERT/MEDIA have partnered to offer you the best technology and individual consultation and licensing from a single source. We are happy to assist you in the evaluation, licensing and adoption of – please talk to us!

Lesen Sie diesen Artikel auf Deutsch.

Further information Professional Diagrams in Confluence and JIRA
Diagrams in Confluence: Comparison between Creately and
Diagrams in Confluence and JIRA: versus Gliffy
JGraph and //SEIBERT/MEDIA are partners