Using Draw.io html export files in SharePoint sites

15 views
Skip to first unread message

Grégory QUERCIA

unread,
Sep 4, 2026, 4:11:21 AM (9 days ago) Sep 4
to dra...@googlegroups.com
Dear support, 

I export my process flow charts in .html format to enable my users to easily browse between the different pages where are located the flow charts. I have however troubles to open the html when this is stored on a local intranet (based on Sharepoint site). It is not opening unless I right click "open with the application". I wish this opens directly in any available browser on the laptop when I click on the file from the sharepoint. 

Thanks for your help!


draw.io Q&A

unread,
Sep 4, 2026, 4:14:23 AM (9 days ago) Sep 4
to draw.io Q&A

This is SharePoint behaviour rather than something in the exported file. SharePoint document libraries deliberately do not display uploaded .html files as web pages. Because any user could upload HTML containing scripts, SharePoint serves them as downloads (or a static preview) instead, which is why you have to open the file with an application yourself. Nothing we can put into the export changes that, since the browser never receives the file as a page.

Your options, roughly in order of how well they tend to work:

  1. Export as PDF instead of HTML. In draw.io choose File > Export as > PDF and select all pages. Links between pages are preserved as clickable links inside the PDF, and SharePoint opens PDFs directly in the browser. This is the closest match to what you have today.
  2. Embed the diagram in a SharePoint page. In draw.io choose File > Embed > IFrame, copy the code, and paste it into an Embed web part on a SharePoint page. Viewers get page tabs and working page links without leaving SharePoint. Your SharePoint administrator may need to allow diagrams.net in the site's HTML Field Security settings, and very large diagrams can exceed the size the embed accepts.
  3. Ask your SharePoint administrator. On SharePoint Server (on-premises) the "Browser File Handling" setting for the web application can be set to Permissive, which lets HTML render inline. On SharePoint Online, rendering HTML depends on custom script being enabled for the site, and Microsoft now resets that automatically, so it is not a reliable route.
  4. Host the HTML on a web server such as an intranet web server or an internal wiki. A document library stores files but does not serve them as web pages.

One more note on the HTML export: it loads the draw.io viewer script from viewer.diagrams.net, so it needs internet access on the laptop even when it does open.

If you meant double-clicking the file in a synced SharePoint folder in File Explorer rather than in the browser, that is a Windows default-app setting: Settings > Apps > Default apps, choose defaults by file type, and set .html to your browser.

Reply all
Reply to author
Forward
0 new messages