Custom icons library for draw.io in Confluence cloud

[Ganthe_ Yash]

We are able to use draw.io with Confluence successfully. However, we would like to add a lot of custom icons to the available icons in draw.io. We would like all users of the Confluence cloud tenant to have a consistent set of our corporate icons. What is the best way to do this ?

[MJ Valencia _draw_io diagrams_]

Hi @Ganthe_ Yash

Thanks for your question! The best way to achieve this in draw.io is by creating a custom shape library and making it accessible to all users. 

Here's how you can do it: 

1. Convert your icons to SVG format (my personal favorite for best quality) or PNG/JPEG 

2. Open draw.io within Confluence 

3. Click on File > New Library > Device (this creates a new library) 

4. Name your library and drag and drop your custom icons 

5. Click save when you're ready and your library should now appear in the Shapes panel on the left. 

You can drag and drop additional shapes from your diagram into the custom library or import icons directly from your computer. Now let's help you share with your team. They can access your custom library by: 

1. Save the library file to a shared location where team members have access i.e. Google Drive. They can then import the library by clicking File > Import Library and navigating to the saved file.

or 

2. If you want the icons to always be available to users without needing to import them manually, you can configure draw.io to load them via a publicly accessible URL. 

Here's a blog post that may help you as well :) 

[Ganthe_ Yash]

A corporate organization will not prefer storing the library at a publicly accessible URL. Is there a way it can be uploaded to the Atlassian cloud tenant so that draw.io can securely access it?

[Bastian -drawio Diagrams-]

Hi @Ganthe_ Yash . When MJ stated "all users", she meant "all users inside your organisation". Your custom library is stored inside Confluence Cloud only, just like all of your diagrams and whiteboards :)

[Ganthe_ Yash]

I understand that the library will be accessible to all users only in my organization. However, to configure it to be accessible that way, we need to place the xml file at a public URL as described in the blog post mentioned in the last line of MJ's response. 

[Bastian -drawio Diagrams-]

Hi @Ganthe_ Yash, I understand. We sent you the wrong link by mistake. MJ sent you the blog post for the standalone web service. Creating custom libraries within Atlassian is different, though, as draw.io is fully integrated into Confluence. Please have a look at the blog post at https://drawio-app.com/blog/draw-io-training-exercise-9-create-your-own-custom-library/ instead to see how to create, export, and embed a custom library in Confluence. Again, I'm sorry; I didn't see the issue with the wrong link in the first place.