Custom icons library for draw.io in Confluence cloud

Ganthe_ Yash
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
February 24, 2025

 

 

 

 

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 ?

1 answer

1 vote
MJ Valencia _draw_io diagrams_
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
February 24, 2025

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
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
February 24, 2025

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-
Atlassian Partner
February 25, 2025

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'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
February 25, 2025

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-
Atlassian Partner
February 25, 2025

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.

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
ENTERPRISE
TAGS
AUG Leaders

Atlassian Community Events