---
title: "Quick start"
canonical: "https://support.appfire.com/space/SCAFC/477468993/Quick%20start"
format: markdown
---
This is a quick start guide to help you begin working with Scaffolding.

| **On this page:**<br>> Macro (toc) |
| --- |

## Overview

This example demonstrates how to create a knowledge base of multiple articles structured as follows.

![Screenshot displaying multiple pages, each with three sections - Summary, Diagnosis, and Cause.](media://ab313fc8-cf13-41ef-a0c2-279e63ef8c96)

## Set up the template

> 📝 You must be a space administrator to view the *Space settings* menu.

1. Go to **Space settings **>** Look and feel **>** Templates**.
2. Click **Create a new template.**
3. Name the template `Knowledge Base Article Template`*.*
4. Insert the **Scaffolding - Field Group** macro in the template editor.

The *Insert Scaffolding - Field group macro* dialog opens.

5. In the sidebar, expand the **Add Fields** section to view the available fields.
6. Drag a **Paragraph **field from the sidebar into the editor area, and enter the text `Summary` above it using the Heading 2 style.
7. Insert a 2 x 2 table, and enter `System`* *and `Version` into the left-hand cells.
8. Click the empty cell next to *System* and drag the **Dropdown List** field into it from the sidebar.
9. Fill in the labels for the dropdown list, for example, `Mac OS X`, `Windows 10`, and `Ubuntu`.
  1. Click **Edit **(:edit-pencil:) on the *Dropdown list* field to open its *Field settings* section in the sidebar.
  2. 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.
10. Click the empty cell next to *Version *and drag the **Number** field into it from the sidebar.
11. Add `Diagnosis`, `Cause`*,* and `Solution`* *sections, each containing a Paragraph field. See Step 6 for details.
12. Click **Insert** to insert the Field Group macro.
13. Save the template.

## Create a page from the template

1. Create a new page and insert the **Scaffolding -** **Live Template** macro.
2. From the **Template name** dropdown list, select your template, **Knowledge Base Article Template, **and click** Insert**.
3. Enter a page title and publish the page.

## Add content to the page with the template

1. On the newly published page using the live template, click **Edit content** within the Field Group macro.
2. Populate the fields accordingly. The Paragraph field editor supports most features from the standard Confluence Cloud editor, including fonts, text color, lists, links, and more.
3. Select 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.
  
4. Enter a number in the *Version *cell. As you configured the field earlier in the template, it accepts only numbers.
  
5. Fill in the rest of the fields as needed and click** Publish **to save your data.

## Update the template

Let’s modify the template to demonstrate the Live Template macro's benefits.

1. Go back to the *Knowledge Base Article Template *you created and open it in edit mode.
2. Click **Edit** (:edit-pencil:) on the *Field Group* macro.
3. Modify the Field Group macro.
  1. Add a section titled `Contact info` and drag a Paragraph field within it.
  2. In the *Summary* section, modify the table by changing *System* to `Operating System`* *and *Version* to `Version Affected`.
4. Click **Save** to save the Field Group macro.
5. Click **Save** to save the template.
6. 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.

> ℹ️ You can manage tens or even hundreds of pages by applying changes to the template alone.

## Tips

|  |  |
| --- | --- |
| **In the Scaffolding - Field Group macro editor**<br>You can insert fields quickly by typing `/` and the beginning of a field name, for example, `/paragraph`*. * | ![scaffolding-tip1.png](media://70ad4f4c-b2ea-4606-b7cc-46b68b23e580) |
| **In the Scaffolding - Field Group macro editor** **toolbar**<br>You can insert a table by clicking the **Table** icon. | ![scaffolding-tip2.png](media://b3d39891-9598-4f78-ad0d-ec165ae53d27) |
| **To speed up macro entry with autocomplete:**<br>- **In the new editor, **type `/` and the beginning of an element (tool or things in the insert menu) to see a list of suggestions.
- **In the legacy editor, **type `{` and the beginning of the macro name to see a list of suggested macros. | ![scaffolding-tip3.png](media://42bb4d6f-3819-4de8-8cda-69c4d0250824) |

For more details about using Scaffolding, see [https://appfire.atlassian.net/wiki/spaces/SCAFC/pages/477463707](https://appfire.atlassian.net/wiki/spaces/SCAFC/pages/477463707).