This article has not yet been verified against Umbraco 8.

    The concepts and code examples might not work if you are running Umbraco 8.0 or a later version. If you are using Umbraco 7, this article is perfect for you!

    You are more than welcome to report any issues found on the Documentation Issue Tracker.

    Custom file systems (IFileSystem)

    By default, Umbraco uses an instance of PhysicalFileSystem to handle the media archive. The configuration for this can be found in /config/FileSystemProviders.config.

    <Provider alias="media" type="Umbraco.Core.IO.PhysicalFileSystem, Umbraco.Core">
            <add key="virtualRoot" value="~/media/" />

    PhysicalFileSystem implements the IFileSystem interface, and it is possible to replace it with a custom class - eg. if you want your media files stored on Azure or something similar.

    If you configure Umbraco to use a custom file system provider for media, you most likely won't need to access the implementation directly. Umbraco uses a wrapper class called MediaFileSystem. You can get a reference to this wrapper class with the following code:

    MediaFileSystem media = FileSystemProviderManager.Current.GetFileSystemProvider<MediaFileSystem>();

    This will be enough in most cases and is the way Umbraco will access the file system provider. The wrapper class implements the same interface IFileSystem as any custom providers should do, so you will be able to call the same methods.

    If your custom file system provider has some extra logic that you need to access, you can of course get a reference to the actual instance of IFileSystem. This can be archived through the following code:

    IFileSystem fs = FileSystemProviderManager.Current.GetUnderlyingFileSystemProvider("media");

    Or alternately something like:

    CustomFileSystem fs = FileSystemProviderManager.Current.GetUnderlyingFileSystemProvider("media") as CustomFileSystem;
    if (fs != null) {
        // Do some stuff here

    Both IFileSystem and FileSystemProviderManager are located in the Umbraco.Core.IO namespace.

    Custom providers