# SharinPix Form Formula: Fields and Attributes
### Overview
{% hint style="info" %}
The **SharinPix Form Formula Field** allows you to dynamically reference and manipulate data. Using formulas, you can combine static values with live data coming from form inputs and other sources to create flexible, data-driven form templates.
This article covers the following:
* [Accessing Form Fields](#overview)
* [Accessing Attributes of Form Fields](#accessing-attributes-of-form-fields)
{% endhint %}
{% hint style="success" %}
**Tips:**
[Follow this documentation](https://docs.sharinpix.com/forms/form-elements/sharinpix-form-formula-functions-and-operators) to learn more about the Functions and Operators available in a SharinPix Form Formula Field
{% endhint %}
### Getting Started
Formulas can reference data from the following sources:
1. **Current Form Fields:** Values entered by the end-user (e.g., `elementAPIName`).
2. **URL Parameters:** Data passed when launching the form via the `form.params.` prefix (e.g., `form.params.approval_threshold`).
### Accessing Form Fields
Any question with an API name can be used in a formula field. An API name can be added to a question using the *API Name field* on the form builder, as shown below.
The SerialNumber field can then be used in formula fields as shown above
{% hint style="danger" %}
A section or page cannot contain fields with the same API name.
{% endhint %}
#### Accessing nested fields
To access a nested field, i.e a field found inside a section, make sure to add an API name to the Section element as well. In the picture below the API name "Bedroom" is added to a Section element.
The "Bedroom" Section element contains a Radio question with the "ACWorking" API name as shown below.
To reference the "ACWorking" Radio question in a formula field found **outside** the "Bedroom" Section, it should be *prefixed* with the Section's API name as shown in the example below.
{% hint style="success" %}
**Tips:**
A field can be referenced without any prefix if it is being used in the same level (i.e, the section where it is found)
{% endhint %}
#### Accessing parent fields
The `parent` attribute is available for any question found in a section.
By using the `parent` attribute, we can access the attributes of the section as shown below.
{% hint style="success" %}
**Tips:**
You can use `.parent` to move up the elements tree and reference questions in other sections. For example:
`parent.parent.SiblingSection.ACWorking`
{% endhint %}
if you need to reference a **root-level (main page)** question inside a formula field for a question **nested** in a section, you can reference it by using the [**form**](#global-form-attributes) global field.
In the example below, the form includes a radio question with the API name `VisitType` on the main page, and a capture question inside the **Bedroom** section.
To reference `VisitType` from a formula on a question in the **Bedroom** section, use `form.VisitType`, as shown below.
### Accessing Attributes of Form Fields
A field can contain several attributes based on its type and they can be accessed by adding a "." following a field API name.
#### Generic Questions attributes
These attributes are available on almost all questions.
| Attribute | Purpose |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| value | Returns the current value of the field |
| displayValue | Returns the current value of the field as displayed on the UI |
| label | Returns the label of the question |
| mediaCount | Returns the number of media associated with the question |
| note | Returns the current note added to the question if any |
| reference | Return the previous value of the question in the context of a [follow-up form](https://docs.sharinpix.com/forms/advanced-form-configuration/form-features-initial-follow-up-form-responses-comparative-form) |
| visible | Returns whether the question is currently visible or not (This is available to use only if the question has a visibility formula configured) |
**displayValue attribute**
This attribute returns the current value of the field as shown on the UI.
For example, if a question has a label configured for a particular value, then that label will be returned in the formula as shown below.
For date questions it returns the date value as a formatted string, using the date format configured on the question.
#### Section Attributes
These attributes are only available to sections.
| Attribute | Purpose |
| ---------------------- | --------------------------------------------------------------------------- |
| \_questionsCount | Returns the number of visible questions that are inside the section |
| \_questionsFilledCount | Returns the number of visible questions that have filled inside the section |
| index | Returns the index of the section if it a repeated section |
The API names of the questions inside the Section are also attributes of the Section.
If a Section is a Repeated Section, it will also have the `index` attribute, which returns its position in the Repeated element as shown below.
### Repeated Sections attributes
These attributes are only available to the Repeated Sections element.
| Attribute | Purpose |
| --------- | ------------------------------------------------ |
| size | Returns the number of sections added by the user |
The nested fields of the repeated sections can also be referenced. Follow [this documentation](https://docs.sharinpix.com/forms/form-sections-and-repeated-sections/sharinpix-form-formula-referencing-repeated-section-fields) to learn more.
#### Global form attributes
There are several global attributes that can be accessed by using the `form` keyword
| Attribute | Purpose |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| compare | Returns `true` when the form being filled is a follow-up form. |
| params | Allows accessing the url params found in the url that was used to load the form. Follow [this documentation](https://docs.sharinpix.com/forms/advanced-form-configuration/sharinpix-forms-context-parameters) to learn more about this attribute. |
| response | Returns details of the SharinPix Form Response record. This can be used to show additional details on the [SharinPix Form PDF](https://docs.sharinpix.com/forms/form-pdf-configuration/sharinpix-forms-pdf-configuration). |
| template | Returns details of the SharinPix Form Template record. |
| view | Returns `"print"` in the context of pdf. This is useful for hiding or show specific fields on the [SharinPix Form PDF](https://docs.sharinpix.com/forms/form-pdf-configuration/sharinpix-forms-pdf-configuration). |
**response attribute**
This attribute of the `form` global field contains nested attributes about a SharinPix Form Response record created by the form.
| Attribute | Purpose |
| --------- | ------------------------------------------------------ |
| sfid | The Salesforce Record ID linked to the form response |
| sfname | The Salesforce Record Name linked to the form response |
**template attribute**
This attribute of the `form` global field contains nested attributes about the SharinPix Form Template record.
| Attribute | Purpose |
| --------- | ---------------------- |
| sfid | The Form Template ID |
| sfname | The Form Template Name |
**Root-level fields**
The questions found on the main page can also be referenced directly by using the `form` field as shown below.
{% hint style="success" %}
**Tips:**
This can be used to reference a root-level question from a nested formula field.
{% endhint %}
.png?alt=media&token=14dd54aa-d6e4-4ddb-8697-77f0c1b5fbae)
.png?alt=media&token=de419615-5db7-4b51-ad2b-b697bb43a30b)
.png?alt=media&token=2896d1ef-1e69-4ad4-879d-33f9c7bd2aa8)
.png?alt=media&token=14eeb1b0-bf37-4413-b611-a8101c65c093)
.png?alt=media&token=20a7c219-d918-4136-ba3f-ab84cadbd6c7)
.png?alt=media&token=0ff52f92-ded9-4055-aaae-80763f4e43f6)
.png?alt=media&token=e9b6a208-38a3-4dd1-9908-b43dbeb7daf4)
.png?alt=media&token=dd76dc29-10fd-4769-be27-85f125af5c95)
.png?alt=media&token=489c3b20-c5d4-442e-9fec-f7866c86a5d5)
.png?alt=media&token=408c2da4-1432-45d4-972f-e131959663a5)
.png?alt=media&token=1cebfe42-38f8-4579-9052-aff7d6152cdb)