Include page

Include page shows the whole of another page inside this one. Write something once, such as a disclaimer, the office address or a “how to get help” box, include it wherever it belongs, and when it changes, it changes everywhere.

Readers always see the other page’s current published version, so there is never an old copy to track down.

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.

Until you choose a page in its settings, it says Choose a page to include.

Live on this page

The page How live content works holds the notes that apply to every live content block. Rather than repeat them on each page, here they are, included. Everything between this paragraph and the next one comes from that page, as it is today.

The line down the left of its first paragraph marks that paragraph as the page’s excerpt. Excerpt include shows only that part.

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.

• Page: the page to show. Type two or more letters of its title in Search for a page, then choose it from the list; each result shows its space’s key. The chosen page’s title appears above the search box. You can also paste a page’s id there.

The page can be in any space. A few things the block says instead of showing it:

• Nothing to show: the page is missing, or you cannot see it. The page was deleted, or this reader is not allowed to see it. It never says which, so a hidden page stays hidden.

• A page cannot include itself. Choose another page.

• Shown on the page, in place of a live block inside the included page. Blocks are looked up one level deep, so two pages cannot include each other forever.

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

• Keep the shared page short and self-contained: a paragraph, a list or a panel that makes sense wherever it lands.

• Want only part of a page? Mark that part as an Excerpt and use Excerpt include.

• Check who can see the source. Readers who cannot open it see the message above, not its content.

Related

• Excerpt include shows one marked part of a page.

• Excerpt marks that part.

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