Quick start
This is a quick start guide to help you begin working with Scaffolding.
Overview
This example demonstrates how to create a knowledge base of multiple articles structured as follows.
Set up the template
You must be a space administrator to view the Space settings menu.
Go to Space settings > Look and feel > Templates.
Screenshot of the Space settings menu in Confluence.Click Create a new template.
Name the template
Knowledge Base Article Template
.Insert the Scaffolding - Field Group macro in the template editor.
The Scaffolding - Field Group macro
The Insert Scaffolding - Field group macro dialog opens.
In the sidebar, expand the Add Fields section to view the available fields.
Drag a Paragraph field from the sidebar into the editor area, and enter the text
Summary
above it using the Heading 2 style.Summary section with a Paragraph fieldInsert a 2 x 2 table, and enter
System
andVersion
into the left-hand cells.System/Version table within the Summary sectionClick the empty cell next to System and drag the Dropdown List field into it from the sidebar.
Dropdown list field in the System cellFill in the labels for the dropdown list, for example,
Mac OS X
,Windows 10
, andUbuntu
.Click Edit () on the Dropdown list field to open its Field settings section in the sidebar.
To create a label, in the Labels box, enter the label text, select a color for the label, and press
Enter
. The label is auto-saved.Dropdown list field settings
Click the empty cell next to Version and drag the Number field into it from the sidebar.
Add
Diagnosis
,Cause
, andSolution
sections, each containing a Paragraph field. See Step 6 for details.Diagnosis section after the Summary sectionClick Insert to insert the Field Group macro.
Inserted Scaffolding - Field Group macoSave the template.
Create a page from the template
Create a new page and insert the Scaffolding - Live Template macro.
The Scaffolding - Live Template macroFrom the Template name dropdown list, select your template, Knowledge Base Article Template, and click Insert.
The Scaffolding - Live Template macro configurationsEnter a page title and publish the page.
Inserted Scaffolding - Live Template macro
Add content to the page with the template
On the newly published page using the live template, click Edit content within the Field Group macro.
Edit content button for entering Scaffolding dataPopulate the fields accordingly. The Paragraph field editor supports most features from the standard Confluence Cloud editor, including fonts, text color, lists, links, and more.
The Paragraph field foe entering rich textSelect an option from the System dropdown menu. The System cell includes a dropdown menu that lets you select an option from the labels you created earlier in the template.
The System field for selecting a label from a dropdown listEnter a number in the Version cell. As you configured the field earlier in the template, it accepts only numbers.
The Version field for entering a numberFill in the rest of the fields as needed and click Publish to save your data.
Published Scaffolding data
Update the template
Let’s modify the template to demonstrate the Live Template macro's benefits.
Go back to the Knowledge Base Article Template you created and open it in edit mode.
Click Edit () on the Field Group macro.
The Edit icon on the Scaffolding - Field Group macroModify the Field Group macro.
Add a section titled
Contact info
and drag a Paragraph field within it.In the Summary section, modify the table by changing System to
Operating System
and Version toVersion Affected
.The modified table field in the Field Group macro editor
Click Save to save the Field Group macro.
Click Save to save the template.
Go back to the page that uses the template.
The changes you made to the template are automatically reflected on the page that uses the template, without the need to edit the page individually.The Operating System/Version Affected table on the page that uses the template
You can manage tens or even hundreds of pages by applying changes to the template alone.
Tips
In the Scaffolding - Field Group macro editor You can insert fields quickly by typing | |
In the Scaffolding - Field Group macro editor toolbar You can insert a table by clicking the Table icon. | |
To speed up macro entry with autocomplete:
|
|
For more details about using Scaffolding, see Use cases.
Need support? Create a request with our support team.
Copyright © 2005 - 2025 Appfire | All rights reserved.