Live Template

Owned by Robert Alexander Marshall
Last updated: Apr 01, 2024 by Karina Zoin
3 min read
1 Description | 2 Parameters | 3 Editor View | 4 Macro Edit View | 5 Issues in use | 6 Tutorial Examples

Description

Dynamically inherit a template's structure and layout. Changes to the template will be automatically reflected on this page. The Live Template macro is best used together with the Field Group macro.

Key concepts details the functionality and use of this macro.

You can also use or customize 11 field group templates. To learn more - Using the field group template library.  

Parameters

Name

Required

Default Value

Description

Name

Required

Default Value

Description

Template type

 Yes

Confluence template/blueprint

The type of the template to use.

The template may be one of

  • Confluence template/blueprint - the type of page template to import and render for the page

If a space template and global template have the same name, the space template gets priority.

  • Confluence page - a Confluence page

Space

 Optional

[current space]

The space where the template is located

  • leave blank for the current space.

This parameter is used together with the Template name parameter.

Template name

 Yes

 

The name of the page template to import and render

  • the relevant template can be selected from a list of suggested values

Editor View

Macro Edit View

20230414 live template view.png

 

Issues in use

Issue

Details

Knowledge Base

Issue

Details

Knowledge Base

Issues with large number of pages

If a live template is being used for a large number of pages (e.g. hundreds or thousands of pages)

  • any changes to the live template document may take some time to propagate to all the affected pages as this equivalent to editing all the pages at the same time

This means end users may briefly see old content on pages instead of the newly-changed/added content.

Similarly, the new content may not be immediately indexed by Confluence, so it may not show up in searches right away. Confluence will usually propagate and index new content within a few minutes.

 

Issues with global templates

Why can't I preview Scaffolding cloud macros in global templates?

Issues with images & files

  • Images & Files are disabled in the Field Group macro

 

  • Files & Images are disabled in the Tabs macro

 

Issues with Scaffolding Field Group

There is no option to edit the Scaffolding Field Group macro in a template (global or space).

Unable to edit Scaffolding Field Group once it has been saved in a template

Issues with Include Page macro

When selecting a page with Live template in the Include Page macro, the page is shown with template's field but the content within is not carried over.

 

Tutorial Examples