Scaffolding - Live Template
With the Scaffolding - Live Template macro, you can dynamically reuse the structure and layout of a Confluence template or page.
Description
If the source template or page is updated, the Live Template macro automatically reflects those changes in real time, eliminating the need to update each page or reinsert the macro manually. This enhances maintainability and ensures consistency across multiple pages.
For best results, combine the Live Template macro with the Field Group macro, using the Field Group to define the structure in your source template or page.
Macro editor
When inserting or editing the Live Template macro, the macro editor lets you configure the macro parameters.
Macro parameters
The parameters in the macro editor let you specify the source template or page.
Name | Type | Default Value | Description |
|---|---|---|---|
Template type | Required | Confluence template/blueprint | Specifies the type of source to import and render. Can be:
If a space template and a global template have the same name, the space template gets priority.
This option lets a non-space administrator to maintain the source template. Also, this option ensures version control of the source template. For details, see Ensure version control for live templates by choosing Confluence pages over templates.
|
Space | Required | current space | Specifies the space that contains the source template or page. |
Template name | Required | N/A | Specifies the name of the source template or page. The field provides a search with a drop-down list that displays the available sources based on the values of the Template type and Space parameters. |
Known issues
Issue | Details | Knowledge Base |
|---|---|---|
Issues with a large number of pages | If a live template is used for a large number of pages (e.g. hundreds or thousands of pages), any changes to the source template or page can take some time to propagate to all the affected pages, as this is equivalent to editing all the pages at the same time. This means end users can briefly see old content on pages instead of the newly changed/added content. Similarly, the new content can not be immediately indexed by Confluence, so it cannot show up in searches right away. Confluence usually propagates and indexes new content within a few minutes. Users who are viewing the page when its source template or page is updated can be prompted to reload the page. |
|
Issues with the Include Page macro | When selecting a page with a Live Template macro in the Include Page macro, the page is shown with the template's field, but the content within is not carried over. A community ticket has been raised with Atlassian to discuss this limitation. See Include Page macro fails to render page content that is rendered from the content. |
|
Example use cases
Need support? Create a request with our support team.