Children Macro
Last modified by Simon Urli on 2025/04/23 13:51
 | Displays a tree-view of all children of the current page |
| Type | XAR |
| Category | Macro |
| Developed by | |
| Rating | |
| License | GNU Lesser General Public License 2.1 |
| Bundled With | XWiki Standard |
| Compatibility | Since 8.3M1 |
Table of contents
Description
Displays a tree-view of the children of the current page (using the Document Tree Macro). This macro is part of the Document Tree Macro extension.
Usage
WYSIWYG Editor
You can insert this macro from the WYSIWYG Editor, either through the quick actions (slash) or through the insert macro modal.
Wiki Syntax
{{children sort="date:desc" /}}Parameters
| Name | Optional | Description | Default Value | |
|---|---|---|---|---|
| sort | yes | XWiki 16.10.3+, 17.0.0+ The page field used to sort the child pages, followed by the sort order. The following page fields are currently supported: name, title, date (last modification date) and creationDate. You can optionally indicate the sort order: asc (ascending) or desc (descending) | title:asc | |
| root | yes | XWiki 16.10.6+, 17.3.0+ Allows to display the children of the given document reference, instead of using the current document. The format of a node identifier is document:entityReference (see how to get the reference of a page). | Current document |
Example
Put the following inside the Sandbox home page (for example):
{{children/}}Results in:
