---
title: "HBS_FORM_VALUE"
manual: "Handlebars"
version: "main"
permalink: "https://docs.typo3.org/permalink/cpsit/typo3-handlebars-forms:co-hbs-form-value@main"
source: "Usage/ContentObjects/FormValue.rst"
rendered: "2026-09-29T09:18:02+00:00"
---

# HBS_FORM_VALUE {#co-hbs-form-value}

Reads the current or submitted value of the form element. Internally wraps
EXT:form's `<formvh:renderFormValue>` view helper and exposes its result
as a `FormValueViewModel`.

Without an `output` key the resolved `processedValue` is
returned directly.

**Output instructions**

The `output` key accepts one of the following built-in instructions:

-   **PROCESSED_VALUE**

    -   *Type:* string instruction

    The formatted, human-readable value (e.g. option label for select fields).

-   **VALUE**

    -   *Type:* string instruction

    The raw, machine-readable value.

-   **IS_MULTI_VALUE**

    -   *Type:* string instruction

    Boolean – whether the field holds multiple values (e.g. multi-select,
    multi-checkbox).

-   **IS_SECTION**

    -   *Type:* string instruction

    Boolean – whether the renderable is a section (fieldset, page).

-   **EACH_PROCESSED_VALUE**

    -   *Type:* string instruction

    Iterates over all values and processes each with the sub-configuration in
    `output`.

-   **EACH_VALUE**

    -   *Type:* string instruction

    Like `EACH_PROCESSED_VALUE` but uses raw values.

**Examples**

```typoscript
# Summary page: show the human-readable value
value = HBS_FORM_VALUE
value.output = PROCESSED_VALUE

# Multi-value field: iterate over each option
values = HBS_FORM_VALUE
values {
    output = EACH_PROCESSED_VALUE
    output {
        label = HBS_LABEL

        selected = HBS_PROPERTY
        selected.path = selected
    }
}
```