Cannot link to local files from within Confluence
Platform Notice: Data Center Only - This article only applies to Atlassian apps on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Problem
It's not possible to link to a local file from within Confluence using a file:// URL.
Cause
Modern browsers have security features that prevent linking from remote web pages to local content. URLs that begin with the file:// URI Scheme can only be loaded directly (by typing them into the location bar) or from pages that are loaded using the file:// URI scheme.
Which workaround fits my situation?
Your situation | Recommended workaround |
|---|---|
Files are internal documents your team controls | Import into Confluence — attach the files directly to a Confluence page and link to the attachment |
Files live on a shared internal server | Set up a local web server (IIS, Apache, nginx) to host files over http:// or https:// — then link to the http:// URL |
Files are on a network share (UNC path) | Map the share to a web server — UNC paths ( |
One-off user need (not an admin decision) | Browser extension — users can install a local file link extension, but this is per-browser and not centrally manageable |
Workaround
You can work around the problem by either importing the content into Confluence itself or by setting up a local web server that can host the content using another protocol which won't trigger this error (
http://,https://,ftp://etc.).You can also install a browser extension that will enable local file links
⚠️ Note on Internet Explorer: The IE workaround mentioned in older versions of this article is no longer valid. Internet Explorer reached end of life in June 2022 and is not a supported workaround for Confluence DC. Do not use IE as a solution for local file linking.
Was this helpful?