> 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-plotted-sections.md).

# Form Features - Plotted Sections

## Overview

This article explains how to configure the **Plotted Sections** element on a SharinPix Form Template.

The **Plotted Sections** element uses a sketch as the entry point for a [**Repeated Section**](/forms/form-sections-and-repeated-sections/sharinpix-form-sections-and-repeated-sections-1.md).

Each time a user places a marker on the sketch:

* A new repeated section item is created.
* That item stores the details related to that marker.
* The form can capture structured data for every marked location.

This creates a direct link between the marker location and the data entered for it.

This pattern works well when users need to mark a visual position first and then describe what they found.

{% hint style="info" %}
Use the repeated section template to define which fields are created for each marker.
{% endhint %}

This article explains:

* [How **Plotted Sections** work](#how-plotted-sections-work)
* [How to configure **Plotted Sections**](#how-to-configure-plotted-sections)
* [Using the Marker's Annotation Type in Formulas](#using-the-markers-annotation-type-in-formulas)
* [Demo of **Plotted Sections** with a Building Inspection Example](#demo-building-inspection-example)

## Getting Started

### How to configure Plotted Sections

Follow these steps to configure **Plotted Sections** on your form.

* On the Form Template Editor page, add the **Plotted Sections** element to your form.
* Open the **Plotted Sections** configuration.
* Click **Edit section** to define the repeated section template that will be created for each marker.
* Add the background image and configure the markers that users will work on.

<figure><img src="https://2647402409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRD1Xcn9HtKcyfQ9Ghyk%2Fuploads%2F3eGt3i8crGjiZJ3G52zy%2F1.png?alt=media&amp;token=c6d9660b-706e-467e-9e60-3d5b52f17aff" alt=""><figcaption></figcaption></figure>

* Add the fields that users must complete for each marked point, such as **Area Inspected**, **Condition**, **Are there any issues?**, and **Description of Issues**.

<figure><img src="https://2647402409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRD1Xcn9HtKcyfQ9Ghyk%2Fuploads%2FXqUa8vylGle08FPHDHky%2F2.png?alt=media&amp;token=2c34d332-9aca-4847-b7c1-1ec89ed5f83e" alt=""><figcaption></figcaption></figure>

Each time a user places a marker on the sketch, the form creates one repeated section item linked to that marker.

{% hint style="info" %}
**Info:**

For more information on configuring repeated section items, please follow the article: [SharinPix Form - Repeated Section](/forms/form-sections-and-repeated-sections/sharinpix-form-sections-and-repeated-sections-1.md)
{% endhint %}

### Using the Marker's Annotation Type in Formulas

Each repeated section item created from a marker stores its tool's type and name. Use these attributes in formulas to tailor fields and logic for each marker.

It can be used when marker types identify different assets. For example, a red marker can identify an antenna. A blue marker can identify a splitter. Each item then displays the questions that apply.

| Attribute           | Purpose                                                |
| ------------------- | ------------------------------------------------------ |
| annotation.toolType | Returns the type of the tool used to place the marker. |
| annotation.toolName | Returns the name of the tool used to place the marker. |

<figure><img src="https://2647402409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRD1Xcn9HtKcyfQ9Ghyk%2Fuploads%2FTt7zKQszI6LAgCAGv0z3%2FForm%20Component%20Doc%20%20(12).png?alt=media&amp;token=b124d8eb-6f86-4fa4-ae07-77dbbc003ac1" alt=""><figcaption></figcaption></figure>

Check the tool in the [Annotations Configurator](/documentation/features/user-interface/annotations-configurator.md) before writing a formula. Use the exact configured values.

For example, a free-sketch tool uses the type `path`, not `Path`. A configured tool named `Antenna` uses `Antenna` as its tool name.

```
annotation.toolType = "sticker"
annotation.toolName = "Antenna"
```

{% hint style="success" %}
**Tips:**

* Inside the repeated section item created for a marker, reference these directly: annotation.toolType and annotation.toolName.
* From a nested question inside that section, reference them through the parent section: parent.annotation.toolType and parent.annotation.toolName.
  {% endhint %}

#### Formula Example

<figure><img src="https://2647402409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRD1Xcn9HtKcyfQ9Ghyk%2Fuploads%2FeT1X3Tap9kETYA0V12te%2FCopy%20of%20DOC%20SF%20-%201920%20x%201080.png?alt=media&amp;token=b16b3428-27c8-4fd8-89f7-1a3ec22ca0d7" alt=""><figcaption></figcaption></figure>

Used as the visibility formula on an "Antenna Details" field inside the repeated section template, this field only appears on section items created with the "Antenna" sticker.

{% hint style="info" %}
**Info:**

For more information on writing formulas, please follow these articles: [SharinPix Form Formula Functions and Operators](/forms/form-elements/sharinpix-form-formula-functions-and-operators.md) and [SharinPix Form Formula: Fields and Attributes](/forms/form-elements/sharinpix-form-formula-fields-and-attributes.md)
{% endhint %}

## Demo: Building Inspection Example

This section demonstrates how to use **Plotted Sections** for a building inspection. The inspector marks locations on a building sketch, then captures the condition and any issues found for each marked area.

Follow these steps to configure **Plotted Sections** on your form:

* Add the **Plotted Sections** element to the form.
* Open **Edit section** and add the fields that should be completed for each sticker:

| Label                              | Question Type |
| ---------------------------------- | ------------- |
| Area Inspected (Interior/Exterior) | Select        |
| Condition                          | Text          |
| Are there any issues?              | Radio         |
| Description of Issues              | Text Area     |

* When filling out the form, place a marker on each inspected area of the sketch.
* Complete the repeated section item created for each sticker.

#### Example:

* When the inspector places a marker on the building sketch, the form creates a repeated section item at that location.
* The inspector can then record whether the area is **Interior** or **Exterior**, describe the condition, and note any issues.

<figure><img src="https://2647402409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRD1Xcn9HtKcyfQ9Ghyk%2Fuploads%2FC9g6mrz1HizPw4doH8CV%2F3.png?alt=media&amp;token=2fbc960a-b74c-4588-b35a-2f28f4cab5de" alt=""><figcaption></figcaption></figure>

* If the inspector places several markers on the sketch, the form creates one repeated section item for each marker.
* This allows each inspection point to retain its own details while remaining linked to its location on the sketch.

<figure><img src="https://2647402409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRD1Xcn9HtKcyfQ9Ghyk%2Fuploads%2FSUmM5wRx0Kiwv3pH3a29%2F4.png?alt=media&amp;token=7976641d-b147-4cb2-af6d-d96e23afed90" alt=""><figcaption></figcaption></figure>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sharinpix.com/forms/form-elements/form-features-plotted-sections.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
