diagrams.net Libraries

Create and share custom libraries:

1. Use the scratchpad or create a new library by clicking File, New Library
2. Once the library appears in the sidebar, you can drag and drop cells and images from the diagram or your harddrive
3. Supported image formats are PNG, JPG, SVG and GIF (including animated GIFs). If you are adding SVG files, you can make the colors of the SVG configurable using this method: https://www.drawio.com/doc/faq/svg-edit-colours
4. When all elements have been added, click the pen icon, add titles to the entries and click Export
5. This will download the library file to your computer
6. To share it, the file must be uploaded to the web and made available via a public URL. One way to do this is to upload it to a public GitHub repository.
7. If you are using GitHub, use the RAW URL of the library which is of the form https://raw.githubusercontent.com/ORG/REPO/REF/PATH/FILENAME.xml, eg. https://raw.githubusercontent.com/jgraph/drawio-libs/main/libs/templates.xml
8. Once you have the URL of the library, you can share it by encoding the URL and adding it the clibs parameter. To encode the URL, paste it into the text box at https://jgraph.github.io/drawio-tools/tools/convert.html and click URL Encode. For our example, this will yield https%3A%2F%2Fjgraph.github.io%2Fdrawio-libs%2Flibs%2Ftemplates.xml
9. Then add this to https://app.diagrams.net/?splash=0&clibs=U, eg. https://app.diagrams.net/?splash=0&clibs=Uhttps%3A%2F%2Fjgraph.github.io%2Fdrawio-libs%2Flibs%2Ftemplates.xml (where splash=0 bypasses the splash screen). Multiple libraries can be specified by separating them with semicolons. Each value must be prefixed with a U if it's a URL, eg. https://app.diagrams.net/?splash=0&clibs=Uhttps%3A%2F%2Fjgraph.github.io%2Fdrawio-libs%2Flibs%2Fun-ocha-icons-bluebox.xml;Uhttps%3A%2F%2Fjgraph.github.io%2Fdrawio-libs%2Flibs%2Fun-ocha-icons.xml
10. You can then share this link and clicking on it will open and install your custom libraries in draw.io

See also: https://www.drawio.com/blog/custom-libraries

Library File Format

Libraries consist of an enclosing <mxlibrary> node containing a JSON array, which in turn contains entries with either an xml property with a compressed or uncompressed mxGraphModel or a data property with an image data URI (in PNG, JPG or SVG). All entries must have a w and h property for the width and height of the cell(s) or image in the entry and an optional title property for the title in the sidebar and preview. For entries with a data property, an optional "aspect": "fixed" may be specified to add aspect=fixed to the style of the image cell, and an optional style attribute can be specified to be added the default style of the image cell. Eg. for "data": "data:image/png,[...]", "aspect": "fixed", "style": "resizable=0;rotatable=0;" the resulting cell style will be shape=image;verticalLabelPosition=bottom;verticalAlign=top;imageAspect=0;aspect=fixed;image=data:image/png,[...];resizable=0;rotatable=0;

For uncompressed xml properties, < must be writter as <, > must be written as > and " must written as \" (escaped), eg. "xml": "<mxGraphModel><root><mxCell id=\"0\"/><mxCell id=\"1\" parent=\"0\"/><mxCell id=\"2\" value=\"Test3\" style=\"whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#000000;\" vertex=\"1\" parent=\"1\"><mxGeometry width=\"120\" height=\"60\" as=\"geometry\"/></mxCell></root></mxGraphModel>"

The compressed XML may be obtained by clicking on the Encode button at https://jgraph.github.io/drawio-tools/tools/convert.html, eg. "xml": "jVBLDoMgED3N7BE2XVdbV131BKROhASE4LTq7TsVWuPCpAuS95lH3gyo2s9t0tHcQocO1AVUnUKgjPxco3Mghe1ANSCl4AfyeuBWqyuiTjjQPwGZAy/tnpiVLIy0uCJwwMaRyXkylvAe9ePjTNyZNUOeSzcVw5D00GP5EBPhfFhqlUqjFoNHSguPTLYjkydOubcwaHtDe02Pmfe/5LYhg7Lkl27HXL3drd8="

Image (raster) Libraries

• Templates: A sample library with basic building blocks for technical diagrams. The Comic template needs Humor Sans.
• UN-OCHA Icons: United Nations Office for the Coordination of Humanitarian Affairs (OCHA) Humanitarian Icons 2012. Superseded by the UN-OCHA Icons v.02 vector library below.
• Genogram: A library with icons for genograms (also known as family diagrams).
• DigitalOcean: A library with icons for DigitalOcean resources (scraped from https://do.co/diagram-kit and https://www.digitalocean.com/press).
  • WARNING: No license is given by DO for these icons. Use at your own risk!

Vector Libraries

• UN-OCHA Icons v.02: United Nations OCHA Humanitarian Icons v.02 (CC0), 387 recolorable UN Blue icons. Successor to the 2012 raster set above.
  • NOTE: OCHA released a newer Humanitarian Icons 2026 set (389 icons, July 2026), but it is licensed CC BY 4.0; the v.02 set above remains the latest CC0 (public domain) release.
• Apache Foundation logos: The icon set by Cir02 of Apache foundation logos.
• Checkout & Delivery Icons: The icon set by EpicPxls contains 35 icons depicting various actions and entities for the common checkout process on an e-commerce site.
• OSA Icons: Open source free technical icons to create security architecture or other technical drawings Open Security Architecture/. (Classic colored set; see OSA Icons Mono below for the current monochrome library.)
• OSA Icons (Mono): Rebuilt Open Security Architecture icon library v2.6 — 79 monochrome stroke-based security icons with editable colours.
  • Icons © Open Security Architecture, licensed CC BY-SA 4.0; repackaged for draw.io with editable-colour CSS classes, artwork otherwise unmodified.
• Flat Color Icons: The complete set of 329 flat colour icons by Icons8.
• Voyage Icons: 40 free icons to spice up your travel agency or the airline website by PrintExpress.
• Gesture and Fingerprints Icons: 100 useful gesture and fingerprints line icons by TheSquid.
• Material Design Icons: Material design icons are the official icon set from Google that are designed under the material design guidelines by Google. (Classic set, frozen upstream since 2020 — see Material Symbols below.)
• Material Symbols: Google's current official icon set (3,894 icons, outlined style, recolorable), Apache 2.0 licensed, by Google.
• Chart Icons: A set of light color chart icons.
• Windows 10 Icons: A set of Windows 10 icons.
• Gnome Icons: Network icons scheme based on Gnome Gorilla's theme.
• Font Awesome: Font Awesome Free 7.3.1 solid and brand icons (1,994 icons, recolorable; Icons: CC BY 4.0) from Font Awesome.
• Heroicons: 576 outline and solid icons (recolorable) by Tailwind Labs (MIT).
• Arista Icons: A set of Arista networking icons.
  • NOTE: Icons date from ~2016 (7010/7050/7150/7250/7280SE/7300/7500E families); the 7280R3/7500R3/7800R3 (2019) and 7060X6/7800R4/7700R4 Etherlink AI (2024) generations are missing. Current official Visio stencils are freely downloadable (no login) from the Literature section of any arista.com product page, but automated fetches are bot-blocked, so refreshing this library needs a manual download plus conversion.
• Commvault Icons: A set of Commvault networking icons.
  • NOTE: These icons date from September 2019 and predate both Commvault's October 2019 logo change and the November 2023 "Commvault Cloud" rebrand. Commvault no longer publishes a public icon set (partner portal only), so this library cannot currently be refreshed.
• Fortinet Icons (2019): A set of Fortinet networking icons from the September 2019 vendor library. Superseded by Fortinet Icons v2 below.
• Fortinet Icons v2 (2026): The current official Fortinet icon library (icons.fortinet.com, June 2026), 796 icons in one library per group.
• Integration Icons: A set of MS Integration icons from Sandro Pereira's stencil pack (MIT), including the Microsoft Fabric and Azure Integration Services shapes added in pack v8.0.1.
• Maki Map Icons: The complete set of 215 map/POI icons (recolorable) by Mapbox (CC0), from v8.2.0 (July 2026).
• Temaki Map Icons: 557 map/POI icons (recolorable) extending the Maki set, by Temaki (CC0), from v5.13.0 (July 2026).
• NPS Symbols: 294 recolorable wayfinding, recreation and accessibility pictographs from the US National Park Service symbol library (BSD), snapshot 27e9720 (July 2026).
• Tabler Icons (Outline): 5,112 recolorable outline icons by Tabler (MIT), v3.45.0 (July 2026).
• Tabler Icons (Filled): 1,054 recolorable filled icons by Tabler (MIT), v3.45.0 (July 2026).
• Fluent UI Icons (Regular): Microsoft Fluent UI System Icons regular style, 2,904 recolorable icons (MIT), v1.1.333 (July 2026).
• Fluent UI Icons (Filled): Microsoft Fluent UI System Icons filled style, 2,943 recolorable icons (MIT), v1.1.333 (July 2026).
• Phosphor Icons: 1,512 icons per weight in Regular, Fill and Duotone (4,536 recolorable entries; duotone layer at 20% opacity) from Phosphor (MIT), v2.1.1 (July 2026).
• Fluent Emoji (Flat): Microsoft Fluent Emoji in the Flat style — 1,595 emoji, default skin tone (MIT), snapshot July 2026.
• IBM Carbon Icons: IBM Carbon Design System icons — 2,715 recolorable icons including the Watson Health and quantum sets (Apache-2.0), @carbon/icons 11.84.0 (July 2026).
• IBM Carbon Pictograms: IBM Carbon Design System pictograms — 1,572 recolorable large-format pictograms (Apache-2.0), @carbon/pictograms 12.80.0 (July 2026).
• Health Icons (Outline): Health Icons outline style — 741 recolorable public-health, medical and clinical icons (CC0), snapshot July 2026.
• Health Icons (Filled): Health Icons filled style — 741 recolorable public-health, medical and clinical icons (CC0), snapshot July 2026.
• Country Flags: All 271 country and region flags (4:3) from flag-icons v7.5.0 (MIT), titled "Name (CODE)" (July 2026).
• Circle Flags: 444 circular flags — countries, subdivisions, language and other flags — from HatScripts/circle-flags (MIT), snapshot July 2026.
• GitLab Icons: GitLab's official UI icon set — 484 recolorable DevOps/CI icons (MIT) from gitlab-org/gitlab-svgs v3.163.0 (July 2026). GitLab logos (tanuki) and third-party file-type/brand logos are intentionally excluded.
• Meteocons Weather: 519 full-colour static weather icons (fill style) by Bas Milius / Meteocons (MIT), @meteocons/svg-static v0.1.0 (July 2026).
• Meteocons Weather (Line): 519 static weather icons in the line style (multicoloured) by Bas Milius / Meteocons (MIT), @meteocons/svg-static v0.1.0 (July 2026).
• OCI Icons: Open Container Initiative artwork concept icons — 65 recolorable container-infrastructure icons (Apache-2.0), snapshot d8ccfe9 (July 2026).
• OCI Logos: Official OCI, runc and OCI Certified logo variants from the same artwork repo — 15 entries (Apache-2.0), snapshot d8ccfe9 (July 2026). Use of the marks is subject to the Linux Foundation trademark policy.
• Kubernetes Icons: A set of Kubernetes icons. Obsolete, as there is currently an integrated set in the app.

Click on a link above to open a library or go to File, Open Library from URL in draw.io and enter an URL of the form https://jgraph.github.io/drawio-libs/libs/templates.xml