The Best Macros To Create A Custom Dashboard

Creating a Custom Dashboard on XWiki enables users to better visualize and analyze the wiki content in real-time. The best macros used inside gadgets allow easy display of Office documents (Office Document Viewer), efficient management of pages (Children, Pages) or data visualization (Gallery, Chars).

Office Document Viewer

The macro offers a view for Office attachments inside the gadget without downloading or importing them. It supports formats like doc, ppt, xls, odt, odp, ods, and the data is displayed using an Office Server.

For example, an Excel document can be stored as an attachment on a wiki page and displayed directly on the Dashboard.


The Children macro displays a tree of children’s pages of the current page.


Chart displays a graphical chart generated from miscellaneous data sources. The chart data can be stored either inline inside the macro content or on a dedicated wiki page. The example below uses inline content inside the gadget macro.


The macro displays an index for easy filtering of the pages created in a specific space or the pages from the entire wiki. It includes many customization options like displaying action buttons (copy, rename, delete), specified columns or the possibility to only list pages found in the passed space.

Gallery Macro

The Gallery Macro helps group and display images using a slide-show view. How to add the macro on the wiki Dashboard:

  • Click on “Add Gadget”
  • Search for “gallery” and click on “Select”
  • Add the images for the slide-show inside the “Content” field and click “Submit”



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store