space-hierarchy macro

space-hierarchy macro

Overview

The space-hierarchy macro displays on the page the hierarchy beneath the current space. It is displayed as a tree representation of the hierarchy.

Rendered space hierarchy

The space hierarchy is defined using the parent-space macro added to each child space.

You can show the hierarchy beneath a different space using the space argument.

Parameters

Parameter

Required

Default

Notes

Parameter

Required

Default

Notes

space

 

Current space

Sets the space to use as the root space for the hierarchical display

  • Value can be the spacekey or  ~<spacename>

The hierarchical root space is displayed as the root space in the tree representation on the page.

Usage

Add the Space Hierarchy macro to a page in a space using the Confluence macro browser.

In the macro editor preview, any spaces set as a child of the root space using the parent-space macro. It is displayed in the tree representation.

Macro editor - Space Hierarchy macro with displayed page tree preview

If the Space key box is left blank, the current space is displayed as the root space. In our example, this is the Human Resources space.

If required, add the spacekey to set the root space for the tree representation.

Reference markup

{space-hierarchy:space=tdt}

Where the space parameter value defines the root space for the tree representation.

Related macros

Related pages

Need support? Create a request with our support team.

Copyright © 2005 - 2025 Appfire | All rights reserved.