Page tree

Page tree shows pages as nested links, like the page tree beside every page, starting either at the page it is on or at the top of the space. Use it for a site map on a space’s home page, or a map of one section on that section’s front page.

It differs from Children display in two ways: it can start at the top of the space, and it can go six levels deep instead of three.

Insert it

Type the command at the start of a line, or after a space, and press Enter. When the list shows more than one block, use the arrow keys or click the one you want. Or choose + on the toolbar: live content blocks are at the end, under Live content. With text selected, the + menu puts the block in place of that text, so click on an empty line first.

It starts with its usual settings: three levels, from this page.

Each setting, live

Each example below is a real Page tree block on this page, with its settings in the heading above it.

Space root, 1 level

The top-level pages of the space: here, the sections of this site. A clean table of contents for a home page.

Space root, 2 levels

The sections and the pages directly in them: a site map. It is long, so here it sits inside an expand; open it to see this whole site two levels deep.

This page, 3 levels (the default)

Starts beneath the page it is on, three levels down. Use it on the front page of a big section, where Children display’s three levels are not enough, or pick up to six.

Not shown here: this page has nothing beneath it, so it would say This page has no sub-pages.

Changing and removing it

While you are editing, click the block. It gets a colored outline, and a small box opens above it with the block’s name and its settings. A change shows in the block straight away; readers see it once you publish or update the page.

• Start at: This page or Space root. This page unless you change it.

• Depth: how many levels to show, from 1 to 6. 3 unless you change it.

Pages are in tree order, the same order as the page tree beside the page. A page someone cannot see is left out of their tree, together with everything under it.

To remove the block, click it and press Delete or Backspace. Only the block goes: the pages, files or tasks it showed are not touched.

Good practice

• One or two levels for most uses. Every extra level multiplies the length.

• Put a long tree in an expand, as above, so it does not push the rest of the page out of sight.

• On a big space, start at a section rather than the root.

Related

• Children display lists the pages under this one, with a choice of sort order.

• Table of contents lists the headings on this page, rather than pages.

• The page tree and reordering: how to change the tree order.

• How live content works: what every live content block has in common, such as who sees what, and what happens in an export.