---
title: "parent-space macro"
canonical: "https://support.appfire.com/space/COMALACM/655759943/parent-space%20macro"
format: markdown
---
> Macro (aura-html)

## <span style="color: #091e42">Overview</span>

<span style="color: #091e42">The </span>`parent-space`<span style="color: #091e42"> macro</span><span style="color: #333333"> can be used to specify the root space for the current space.</span>

<span style="color: #333333">The root space key is added to the body of the macro. </span>

<span style="color: #333333">In setting a space hierarchy in your instance, it is advisable to create an appropriately named space to be set as the root space and the root space home page to be the site home page (as these are shown as the root of the spaces' breadcrumbs).</span>

## Usage

Add the **Parent space** macro to the (*home*) page of a space using the Confluence macro browser:

![image](media://03652800-cbed-4e56-b70a-6cd3825de530)

The macro editor has no options to change.

**Insert** the macro to the page and add the space key for the root space to the body of the macro placeholder.

![image](media://0fee1135-76ce-4458-993f-de9f3ce1918d)

This macro value is not displayed on the page. To see the changes, add the [space-hierarchy macro](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655759770) configured with the same space key used for the parent space.

![image](media://b1dc6123-2ab8-4c7e-b801-2aeffa28b761)

The display on the page will show the space hierarchy.

![image](media://4adf4c24-90d7-4a44-b4ea-efed13e3300d)

Any changes using this macro are also reflected in the [space-breadcrumbs macro](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656677781) (if added).

## Reference markup

```plaintext
{parent-space}root-spacekey{parent-space}
```

## Related macros

> Macro (contentbylabel)

## Related pages

- [Adding metadata to a space](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655988362)
- [Setting up hierarchical spaces](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656676531)
- [Using metadata to define space hierarchies](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656578613)