# Hidden field

## Availability

\[SINCE Orbeon Forms 2018.2]

## What it does

This control supports all the features of a regular control, including:

* label
* validations and alerts
* formulas

However, it doesn't show in the form at runtime. At design-time, the control shows as a box with an icon so that the form author knows that a hidden control is in use.

![Hidden field in Form Builder](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEkBiSDvlXs3VWiO0Zu%2F-LV0SEt6dQcUrbflOiwf%2F-LV0RAMZ3jBYZPyd5pBV%2Fxbl-hidden.png?generation=1546212705923865\&alt=media)

This is useful in the following cases:

* **Holding intermediary calculations:** If the control has a "Calculated Value" and/or "Initial Value" formula, it can be referred to by variable name (like `$my-intermediary-result`) from other formulas.
* **Handling out-of-band validations:** If the control has a label, alert and validations, a failing validation will show in the Error Summary. In addition, this also impacts the Wizard View's lax and strict validation modes, preventing forward navigation until the error is fixed by the user.

*NOTE: With Form Builder, you cannot directly edit the label of a hidden field inline. Instead, use "Control Settings".*

## Basic usage

```markup
<fr:hidden ref="validating">
    <xf:label>Validation</xf:label>
    <xf:alert>Please start the validation before proceeding to the import</xf:alert>
</fr:hidden>
```

## See also

* Blog post: [Hidden fields](https://blog.orbeon.com/2019/02/hidden-fields.html)


---

# Agent Instructions: 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:

```
GET https://doc.orbeon.com/form-runner/component/hidden.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
