Skip to end of banner
Go to start of banner

Live Template

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Current »

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

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

This is a good option if you would like the template to be edited by non-space administrators.

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

Issues in use

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.

Users who happen to be viewing the page when it was being changed may be prompted to reload the page.

Issues with global templates

Due to a Confluence Cloud limitation, you will not be able to preview field group macros in a Global template. You can review the final template in pages.

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

Issues with images & files

Due to limitations in Confluence Cloud, when creating a template

  • 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.

A community ticket has been raised with Atlassian to discuss this limitation

Tutorial Examples




  • No labels