---
title: "Add modules to site and site collection scaffolding"
slug: "add-modules-to-site-and-site-collection-scaffolding-1188193"
abstract: "Extend SXA by adding scaffolded items."
---
# Add modules to site and site collection scaffolding

Scaffolding lets you add modules to [sites and site collections](https://doc.sitecore.com/xp/en/developers/sxa/105/sitecore-experience-accelerator/create-a-site-collection-and-a-site.html "Create a site collection and a site"). SXA modules are stored in the Feature or Foundation folder:

- */sitecore/System/Settings/Foundation/Headless Experience Accelerator/*
- */sitecore/System/Settings/Feature/Headless Experience Accelerator/*

To define your new module, you must add the Site Setup, Site Collection Setup, or Grid Setup item to the module and add action types from the Scaffolding folder (*sitecore/Templates/Foundation/Headless Experience Accelerator/Scaffolding/*).

<details>
<summary><h2>Add a module scaffolding definition</h2></summary>

To add your own module scaffolding definition:

1. Navigate to */sitecore/System/Settings/Foundation/* or */sitecore/System/Settings/Feature/* and add a folder.
2. Right-click the new folder, and click **Insert from template**.
3. In the **Insert from template** dialog box, navigate to *sitecore/Templates/Foundation/Headless Experience Accelerator/Scaffolding/Roots* and, depending on the type of module that you want to add, click **Headless Site Setup** or **Headless Site Collection Setup**, and then click **Insert**.

    ![Add new site setup.](https://doc.sitecore.com/api/markdown-image/xp/en/developers/sxa/105/sitecore-experience-accelerator/images/headless-scaffolding-actions.png)

4. In the **Data** section, depending on the type of module that you want to install, fill in the following fields:

    | **Setup** | **Field** | **Descriptions** |
    | --- | --- | --- |
    | Headless Site Setup | Name | The name of the site module as you want it to display in the site creation wizard. |
    |  | Dependencies | Specify the order in which the modules are installed. |
    |  | Include by default | Select to enable the module by default in the site creation wizard. |
    |  | Include if installed | Depending on whether the selected action was applied to the current site collection, the module will be automatically included.<br><br>If the **Selected** field is empty, you can decide whether to install this module in the new-site creation wizard. |
    |  | Is system module | Select to install the module automatically. In this case, the module does not appear in the dialog box. |
    | Headless Site Collection Setup | Name | The name of the site collection module as you want it to display in the site collection creation wizard. |
    |  | Include by default | Select to enable the module by default in the site collection creation wizard. |
    |  | Is system module | Select to install the module automatically. In this case, the module does not appear in the site colleciton creation wizard. |

</details>

<details>
<summary><h2>Add scaffolding actions</h2></summary>

You can use various action types to define modules. You can add items, edit the template, and execute PowerShell scripts. The available actions are stored in the Actions folder (sitecore/Templates/Foundation/Headless Experience Accelerator/Scaffolding/Actions):

![Scaffolding actions](https://doc.sitecore.com/api/markdown-image/xp/en/developers/sxa/105/sitecore-experience-accelerator/images/scaffolding-actions-site-collection.png)

To add a scaffolding action:

- Navigate to your new module and right-click the setup item that you added for your new module. For example, right-click the Headless Site Setup item and insert the **Add Headless Site Item** action.

    ![Add Site item](https://doc.sitecore.com/api/markdown-image/xp/en/developers/sxa/105/sitecore-experience-accelerator/images/headless-site-add-scaffolding-action.png)

The following actions are available:

- **Action type**: **Field**
- Add Headless Site Collection Item: Location
- Template: Template used to create the new site collection item.
- Name: Name of the item.
- Fields: Field/value mapping to set the fields of the new item after creation.
- Edit Headless Site Collection Template: Template
- Type of action: Select the action type.
- Base templates or insert options templates: Select items to use as an argument for the action selected in the previous field.
- Execute Headless Site Collection Script: Script
- Add Headless Site Item: Location
- Template: Template used to create a new site item.
- Name: Name of the new site item.
- Fields: Field/value mapping to set the fields of the new item after creation.
- Edit Headless Site Item: Template
- Type of action: Select the action type.
- Insert options: Define the insert options for the item.
- Execute Headless Site/Site Collection Script: Script
- Post Setup Step: Script
- Input Validation Step (site): Script
- Post Setup Step: Script
- Input Validation Step (site collection): Script
- Pre Delete Step: Script
- Post Delete Step: Script
- Pre Delete Validation Step:

</details>