> For the complete documentation index, see [llms.txt](https://docs.sharinpix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sharinpix.com/documentation/sharinpix-form/sharinpix-form-sections-and-repeated-sections.md).
# SharinPix Form - Sections and Repeated Sections
## Overview
{% hint style="info" %}
Sections and Repeated Sections are powerful layout elements in the [**SharinPix Form Template Editor**](/documentation/sharinpix-form/sharinpix-form-template-editor.md). They allow administrators to structure forms into logical groups of fields and, when necessary, capture repeating sets of information dynamically.
* **Section**: Used to group related form fields under a labeled block.
* **Repeated Section**: Extends the Section by letting users duplicate the same block multiple times with a “+” button — useful for variable numbers of items (e.g., inspections across multiple floors, multiple deficiencies, or repeating details).
This documentation covers :
1. [The Section Element](#section-element)
2. [The Repeated Section Element](#repeated-section-element)\
\
2.1 [Reordering of Repeated Section Elements](#reordering-of-repeated-sections)
3. [Demo – Air Conditioning Inspection Form](#demo-air-conditioning-inspection-form)
4. [Presets sections on Repeated Section Element](#presets-sections-on-repeated-section-element)
{% endhint %}
{% hint style="warning" %}
**Prerequisites:**
Before using Sections or Repeated Sections:
* Ensure the [**SharinPix Forms Admin**](/documentation/access-and-security/sharinpix-permission-sets.md) permission set is assigned.
* The **latest version of the SharinPix Package** must be installed. Refer to [*this documentation*](/faqs/how-to-update-sharinpix-package-from-the-appexchange.md) to update your package.
{% endhint %}
## Elements
### Section Element
The **Section element** is used to group related inputs and content. It helps keep forms clear and organized.
.png?alt=media)
#### Configuration Options
| Option | Description |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| Label | Name of the section displayed to users. |
| API Name | Unique identifier for referencing in logic or formulas. |
| Label Formula | Dynamically generate section titles based on values or conditions. |
| Edit Section | Clieck to enter the section presented as a blank form template. Customize it by adding your elements. |
| Style | Choose a display style (e.g., default/fold/inline). |
| PDF Answer Column Labels | Option to display column labels when rendering the form in PDF. |
| Advanced → Visible When | [Conditional visibility](/documentation/sharinpix-form/form-features-conditional-visibility.md) rule (show/hide based on formulas). |
#### When to use ?
* Organize form into logical parts (e.g., “Personal Information,” “Inspection Details”).
* Add clarity for long forms by grouping elements.
* Use Label Formula to personalize section headings dynamically.
### Repeated Section Element
The **Repeated Section element** allows administrators to create a template for a group of fields that can be repeated by the end user as many times as needed.
%20\(1\).png?alt=media)
#### Configuration Options
| Option | Description |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Label | Name of the repeated section. |
| API Name | Unique identifier for referencing in logic or formulas. |
| Edit Section | Click to enter the repeated section presented as a blank form template. Customize it by adding your elements. |
| Style | Layout style (e.g., default/fold/inline). |
| Label for each item | Defines the display label for each repeated item (e.g., “Deficiency”). |
| Item API Name | Technical identifier for the repeated item. |
| Label Formula | Automatically generates dynamic labels for repeated items (e.g., `label + " " + TEXT(index)` will show “Deficiency 1,” “Deficiency 2,” etc.). |
| Advanced → Visible When | [Conditional visibility](/documentation/sharinpix-form/form-features-conditional-visibility.md) rule (show/hide based on formulas). |
| Advanced → Validation Rule | Define [validation criteria](/documentation/sharinpix-form/form-features-validations.md) that each repeated block must satisfy. |
| Advanced → Sortable | Allows section reordering with drag and drop |
#### When to use ?
* Collecting details for multiple items of the same type (e.g., one form per air conditioning unit per floor).
* Capturing lists of issues or defects.
* Handling unknown quantities of input (instead of pre-creating fixed sections).
## Demo – Air Conditioning Inspection Form
### Step 1: Add a Section
* Create a **Section** labeled *“General Inspection Information”*.
* Click the "Edit Section" button.
* Place fields like Inspector Name, Date, and Location inside it.
### Step 2: Add a Repeated Section
* Create a **Repeated Section** labeled *“Air Conditioning Unit”*.
* Label for each item: “AirCon Unit”
* Label Formula: `label + " " + TEXT(index)` → generates “AirCon Unit 1,” “AirCon Unit 2,” etc.
* Click the "Edit Section" button.
* Inside the repeated section, add fields for:
* Unit Number
* Observed Deficiencies (Text Area)
* Photo Capture (Capture element)
#### Reordering Of Repeated Sections
* The user can enable Reordering Repeated Sections by checking Sortable in the advanced settings.
* They can then see handles on the side of sections and reorder them with **drag and drop**.
### Step 3: Test in Preview
The user can fill in the "General Inspection Information" section and add one section per floor’s unit by clicking “+ AirCon Unit”.
%20\(1\).png?alt=media)
{% hint style="success" %}
**Tips**
* Use **Sections** to structure the form into easy-to-digest blocks.
* Use **Repeated Sections** when you don’t know in advance how many instances a user will need.
* Apply **Label Formulas** to auto-number items for clarity.
* Add **Validation Rules** in Repeated Sections to enforce quality (e.g., each deficiency must include a description).
* Keep labels consistent to avoid user confusion when multiple instances are created.
* Sections or Repeated Sections can be used to create Child Records on Salesforce. Refer to the documentation below for more information on [**Creation of Child Records With Form Sections**](/documentation/sharinpix-form/create-child-records-with-form-sections.md)
{% endhint %}
## Presets sections on Repeated Section Element
* Users can create **Preset Sections** on a Repeated Section element.
* Each preset includes a label and can be configured with predefined default values.
In the example below, two preset sections have been created: **Small Unit** and **Medium Unit**.\
Both presets have been configured with a default value for the **Unit Number** field.
A **Repeated Section Element** with presets displays a dropdown containing all available Presets. Selecting a preset will add the corresponding preconfigured section.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.sharinpix.com/documentation/sharinpix-form/sharinpix-form-sections-and-repeated-sections.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
%20(1)%20(1).png?alt=media)
%20(1)%20(1).png?alt=media)
%20(1)%20(1).png?alt=media)
%20(1)%20(1).png?alt=media)
%20(1)%20(1).png?alt=media)
%20(1)%20(1).png?alt=media)
%20(1)%20(2).png?alt=media)
%20(3).png?alt=media)