> 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/forms/form-elements/form-features-spacer-element.md).

# Form Features - Spacer Element

## Overview

The **Spacer** element adds vertical spacing between form blocks. It can also act as a visual divider with a background color and it can create a page break in the generated PDF.

### Getting Started

#### How to add a Spacer

1. Open your form template in the **SharinPix Form Template Editor**.
2. From the left sidebar, under **Basic Elements**, select **Spacer**.
3. Drag the Spacer to the position where you want extra space (or a visual divider) between elements.
4. Click the Spacer in the form to open its configuration panel.

<figure><img src="https://2647402409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRD1Xcn9HtKcyfQ9Ghyk%2Fuploads%2FTZ9XSzLSFm42cfZtk3X7%2FForm%20Features%20-%20Spacer%20(1).jpg?alt=media&amp;token=15e0b00b-ef83-4096-b1da-9763f3ce5c1b" alt=""><figcaption></figcaption></figure>

#### Configuration Options

| Option                       | Description                                                                              |
| ---------------------------- | ---------------------------------------------------------------------------------------- |
| **Spacer height**            | Sets the vertical size of the Spacer: **Small**, **Medium**, or **Large**.               |
| **Insert page break on PDF** | When enabled, the Spacer starts a new page in the generated PDF.                         |
| **Color**                    | Sets a background color on the Spacer so it can act as a visual divider or colored band. |
| **Use full width**           | Makes the Spacer and its background color extend across the full form width.             |

Spacers also support conditional visibility, so you can show or hide a Spacer based on other answers.

#### How to configure Spacer height

1. Select the **Spacer** element in the form.
2. In the configuration panel, open the **General** tab.
3. Choose a value for **Spacer height**:
   * **Small** — compact gap (default)
   * **Medium** — moderate gap
   * **Large** — generous gap

The preview updates immediately, so you can adjust spacing between sections as you build the form.

#### How to set a Spacer color

1. Select the **Spacer** element.
2. In the **General** tab, use the **Color** picker to choose a background color.
3. To clear the color and return to a transparent Spacer, select the transparent option in the color picker.

A colored Spacer is useful as a section divider or accent band between groups of questions.

#### How to insert a page break in a PDF

Use this option when related content should stay together on one PDF page, or when a new section should start on a fresh page.

1. Select the **Spacer** element.
2. In the **General** tab, enable [**Insert page break on PDF**](/forms/form-pdf-configuration/sharinpix-forms-pdf-configuration.md#add-page-breaks-on-sharinpix-form-pdf).

<figure><img src="https://2647402409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRD1Xcn9HtKcyfQ9Ghyk%2Fuploads%2FIlfByKpQkFizuIoOzrY1%2FForm%20Features%20-%20Spacer.jpg?alt=media&amp;token=8b4657c5-ca2b-4f27-9cf7-d154b42c5352" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2647402409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRD1Xcn9HtKcyfQ9Ghyk%2Fuploads%2FSUTYVEy1Sv8ognMD7Iz8%2FForm%20Features%20-%20Spacer%20PDF.jpg?alt=media&amp;token=d65392e5-7a7c-4aee-9831-2a7d5b488a9a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Page break and color**

When **Insert page break on PDF** is enabled, the Spacer is used only to split pages. Its **Color** still appears in the form preview, but it is **not** rendered as a colored band on the PDF.
{% endhint %}

#### How to use full-width

1. Select the **Spacer** element.
2. In the **General** tab, enable **Use full width**.

This lets the Spacer stretch across the form. Any background color stretches with it.

{% hint style="success" %}
**Best Practices**

* Use **Small** / **Medium** / **Large** height to control rhythm between sections without adding empty Paragraph elements.
* Prefer **Insert page break on PDF** at natural section boundaries.
* Combine **Color** with **Use full width** when you want a clear visual band that separates major parts of the form.
  {% endhint %}


---

# 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/forms/form-elements/form-features-spacer-element.md?ask=<question>&goal=<user_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.
