File Manager Application (Pro)

Last modified by Administrator on 2020/09/20 00:00

File Manager Application (Pro)

Application to manage a hierarchy of folders and files. It embeds viewers for many known file types, such as office and PDF.

Active Installs64
2 Votes
LicenseGNU Lesser General Public License 2.1
Minimal XWiki version supported XWiki 8.4

This application lets your organize your files inside XWiki using a tree hierarchy of folders. It supports all standard operations like:

  • move
  • rename
  • copy
  • delete on both files and folders.

You can use drag & drop to upload new files and to modify the folder hierarchy.

A wide range of files types can be viewed or played (in case of audio and video files) directly from the wiki. This includes PDF and office documents.



Home Page

On the application home page there is a splitter with the tree of folders on the left and the file live table on the right. To get started you should create a folder. Right click on the root node and select 'New Folder'. Type the folder name then press Enter. Next you can upload a file in the folder you have just created. Select the folder in the tree and on the right, above the empty table, click on 'New File'. Browse the file system to select the desired file or drag and drop it on the dedicated area. Click 'Back' after the file is uploaded and you should see the file in the live table.


Folder Tree

The folder tree lists the root folders and some special nodes:

  • Orphan Folders: the folders that don't have the home page (we call it the drive) as their parent. Normally you shouldn't have orphan folders, but in case you do you can easily fix this by dragging them either into the root of the tree or in any of the non-orphan folders.
  • All Files: this is a meta node that gives you quick access to the list of all files found on the drive (the application space).
  • Orphan Files: the list of files that don't have a parent folder. Normally you shouldn't have orphan files, but in case you do you can easily fix this by moving them to an existing folder.
  • Active Jobs: the list of 'file system' jobs that are currently running. You have to know that whenever you perform a modification like deleting a folder or moving some files a job is triggered that runs in the background to perform that operation. Most of the operations are performed instantly so you don't get to see the active jobs, but sometimes if you do large batch operations this view can be used to check the progress. Also, some jobs may require you to answer some questions. For instance, when you move a folder you may need to specify whether to overwrite or not an existing file. This question will be asked on the Active Jobs view.


You can organize the folders by drag and drop or you can use the context menu to create new folders or to rename them. When you select a folder the file live table gets updated to list only the files from that folder.

File Live Table

The file live table lists the files associated with the currently selected node in the tree (e.g. the files from the selected folder). If you whish to copy or move some files you have to select them, click on the Cut or Copy button from above the live table, then select the target folder from the tree and click on the Paste button from above the live table.


File Upload

To upload a new file in the current folder you have to click on the New File button from above the live table.


Below the drop zone you can see the previous uploads. This includes finished uploads, uploads in progress and even canceled uploads. You can clear the list of uploads. After you upload your files you can go back to the list view which should include the new files.

Folder View

The tree context menu has an entry to open the folder. This will take you to the folder view, which lists the subfolders and the files. You can navigate up and down the tree hierarchy by clicking on the subfolders or on the parent entry ('..'), or by using the breadcrumb.


File View

Clicking on a file link from the file live table will take you to the file view. Here you can view or play the file. Most of the standard file types are supported:

  • in case of text files the Code Macro is used to display the file content using highlighting specific for each file type.
  • in case of image file the image is displayed inline.
  • in case of audio and video files the file is played using the JW Player, when present, or if the browser supports HTML5 audio/video playback then the native players are used.
  • in case of PDF files the PDF Viewer is used, when present.
  • in case of office files the Office Viewer is used, but you need to connect your wiki to an office server first.


Recent Files Macro

Starting with version 2.0RC2 there is a macro available to list the files that have been recently uploaded. You can add this macro as a gadget in a dashboard.



The following macro parameters are available:

NameDescriptionDefault ValueSince
limitThe maximum number of files to list.52.0RC2

Migration from Older Versions

Starting with version 2.0-milestone-1 the File Manager has a new way to organize the files and folders, which is not compatible with older versions. Fortunately, after you upgrade the File Manager you'll get on the File Manager home page a warning message and a button to migrate your files from the old structure to the new one.


Installation Steps

This paid extensions requires XWiki 8.4 or above. In order to install the extension, follow the next steps inside your XWiki instance (on cloud or on premise).

Navigate to the Extension Manager

In the Applications Panel click on "More Applications..." and then "Install new applications...". Alternatively navigate directly to the Administration and select the "Extensions" section.


Install the Extension

Search for the extension you wish to install and use the Install button to install it.


Get a License

Navigate to the "Licenses" section of the Administration, fill your details, look for the extension you just installed in the live table and click the buttons to get a trial license or to buy a license.


Install the License

If you have selected a trial license then you're good and there's nothing else to do. Your trial license is automatically installed.

However if you've selected to buy a license you'll be redirected to a page to perform the payment. At the end you need to come back to the "Licenses" administration section and click on the "Check for Updates" button. This will download and apply the license you bought.

Use the Extension

Start using the Extension! Refer to the extension's documentation to know how to use it.


The price is per year and varies depending on the support level and the number of users.

Support / Users 10 25 50 100 250 500 1000 2500 5000 10000 20000
File Manager Application (Pro) is part of the XWiki Pro package. Purchasing this package you will benefit from more extensions at a better price. Check the full offer in XWiki Pro!


What do you get when you purchase an XWiki extension?

1 year license

By purchasing an XWiki extension license, you'll benefit from it during one year.

Free updates

You benefit from all the extension updates during one year. You are always up to date.

Support included

If you are facing an issue, you can reach the XWiki support. Our team is always available to help.

How to Buy

To buy, install this extension from inside your XWiki instance and follow the instructions.

Release notes








Update the Licensing dependency to version 1.13.4.


Update the PDF Viewer Macro dependency to version 1.9.2.
Update the Licensing dependency to version 1.13.3.


Update the PDF Viewer Macro dependency to version 1.9.1.
Update the Licensing dependency to version 1.13.2.
Update the JW Player Macro dependency to version 2.1.3.
Updated translations

  • French


Bugs fixed:
#4 A failed upload is not always properly notified.
#5 Cannot upload files on IE9.


Update the PDF Viewer Macro dependency to version 1.8.3.
Update the Licensing dependency to version 1.13.


Update the Licensing dependency to version 1.12.2.


Update the PDF Viewer Macro dependency to version 1.8.1.
Update the Licensing dependency to version 1.12.1.


Update the PDF Viewer Macro dependency to version 1.8.
Update the Licensing dependency to version 1.8.
Improve the message displayed when there is no valid license.


Initial paid version.

Extension details

This information is only displayed to Administrators. Your users can't see this tab.


  • GNU Lesser General Public License 2.1




  • xar

Developed by


  • Requires XWiki 8.4 or above.
Installable with the Extension Manager


  • com.xwiki.filemanager:application-filemanager-api 2.2.11
  • com.xwiki.licensing:application-licensing-licensor-api 1.14.4
  • org.webjars:angularjs 1.3.8
  • org.webjars:angular-ui-bootstrap 0.12.0
  • org.webjars:angular-file-upload 2.2.2
  • org.xwiki.platform:xwiki-platform-job-webjar 8.4
  • org.xwiki.platform:xwiki-platform-tree-webjar 8.4
  • org.xwiki.platform:xwiki-platform-rendering-macro-velocity 8.4
  • org.xwiki.platform:xwiki-platform-rendering-macro-include 8.4
  • org.xwiki.rendering:xwiki-rendering-macro-html 8.4
  • org.xwiki.platform:xwiki-platform-localization-source-wiki 8.4
  • org.xwiki.platform:xwiki-platform-sheet-ui 8.4
  • org.xwiki.platform:xwiki-platform-search-solr-ui 8.4
  • org.xwiki.platform:xwiki-platform-jodatime 8.4
  • org.xwiki.platform:xwiki-platform-rendering-macro-code 8.4
  • org.xwiki.platform:xwiki-platform-office-macro 8.4
  • com.xwiki.pdfviewer:macro-pdfviewer-ui 2.0.2
  • org.xwiki.contrib:macro-jwplayer 2.1.3
Created by Administrator on 2018/02/26 13:11
XWiki SAS Copyright © 2019