attachDisplay a livetable with the attachments of a given document
Developed by

Raluca Stavro, Marius Dumitru Florea

1 Votes
LicenseGNU Lesser General Public License 2.1
Installable with the Extension Manager


The Attachments Macro is a macro that lists all the attachments from the current document in a livetable. You can specify parameters such as the sort order or the document to display attachments from. 


{{attachments document="Space.SomeDocWithAttachments" /}}


sortYesThe column to sort by : name (default), type, size, author, date
orderYesSort order : asc (default), desc
limitYesNumber of entries per page (10 by default)
documentYesThe document to display attachments for (current document by default)


Order by attachment name:


Filter by attachment name:


Tested on

This extension has been tested with the following configurations.

Extension VersionXWiki FlavorNotes
2.0XWiki Enterprise 2.7+
3.0XWiki Enterprise 4.3+
3.1XWiki Enterprise 6.4.5+

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki

Release Notes


  • Bugfix: If the macro is used multiple times on the same page only the first instance works. All the rest show "The environment prevents the table from loading data".


  • Bugfix: Attachments with uppercase letters in the file name were not found when searching for these letters


  • Display the user avatar on the author column
  • Removed custom JavaScript code (custom livetable.js and custom live table raw callback)
  • Removed overwritten Velocity macros
  • Replaced deprecated calls
  • Use the new localization module (no need to register the translation bundle in the administration)
  • Use the JSON Velocity tool to generate the JSON for the live table
  • Code cleanup and small refactoring


  • Use a live table to display the list of attachments, instead of a static table
Created by Raluca Stavro on 2012/01/27 09:42

Get Connected