> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Labeled Field

> Labeled Field is a compound element that finds named fields: configure label text, field position, and content types such as number, date, or phone.

**Labeled Field** is a compound element that the program uses to search for fields that have names.

A **Labeled Field** element includes the following subelements:

* **Static Text**, which contains the name of the field.
* [White Gap](/flexi-capture/fls/template/white-gap), which describes the gap between the name and the data of the field.
* An element that describes the contents of the field. Its type depends on the type of the field contents.

**Labeled Field** elements are marked with <img src="https://mintcdn.com/abbyy/lqYknuOmCa79141v/images/flexi-capture/fls/el_labeled_field.gif?s=091e7c3de5c40f31ed7e33731998f065" alt="Labeled Field element icon" style={{display:"inline-block",verticalAlign:"middle",margin:0}} width="17" height="17" data-path="images/flexi-capture/fls/el_labeled_field.gif" /> in the tree.

If required, a **Labeled Field** element can be represented as a group.

When searching for the name of a field, the program considers the **Recognized Words** and **Recognized Lines** objects detected by [pre-recognition](/flexi-capture/fls/batch/prerecognition) that fall within the element's search area. Once the name of the field is detected, the program searches for a field whose contents match the description provided in the element.

## Name properties

The name of a field is described by a [Static Text](/flexi-capture/fls/template/static-text) element.

The properties of the name are specified on the **Label** tab of the element's **Properties** dialog box.

To open the **Properties** dialog box, in the **FlexiLayout** window, right-click the element and select **Properties...** on the shortcut menu.

<Frame>
  <img src="https://mintcdn.com/abbyy/fmgRWFNHKYN2MLSg/images/flexi-capture/fls/Label_tab.gif?fit=max&auto=format&n=fmgRWFNHKYN2MLSg&q=85&s=261012da57cc93e487caadad385df43b" alt="Screenshot of the Label tab of the Labeled Field element's Properties dialog box in ABBYY FlexiLayout Studio." width="431" height="455" data-path="images/flexi-capture/fls/Label_tab.gif" />
</Frame>

### <a id="fieldposition" />Position of a field relative to its name

The position of a field relative to its name is specified on the **Field Position** tab.

<Frame>
  <img src="https://mintcdn.com/abbyy/fmgRWFNHKYN2MLSg/images/flexi-capture/fls/Field_position_tab.gif?fit=max&auto=format&n=fmgRWFNHKYN2MLSg&q=85&s=0355873e9d685f87bfbe600d5d6d4bce" alt="Screenshot of the Field Position tab of the Labeled Field element's Properties dialog box in ABBYY FlexiLayout Studio, showing field position, alignment, minimum space, and search area options." width="431" height="455" data-path="images/flexi-capture/fls/Field_position_tab.gif" />
</Frame>

| Property               | Description                                                                                            |
| ---------------------- | ------------------------------------------------------------------------------------------------------ |
| **Field Position**     | Specifies the position of the field relative to its name (to the right, to the left, above, or below). |
| **Minimum space**      | Specifies the minimum space between the name and the field (in user-defined units of measurement).     |
| **Search area width**  | Specifies the width of the search area (in user-defined units of measurement).                         |
| **Search area height** | Specifies the height of the search area (in user-defined units of measurement).                        |

**Field alignment** specifies the alignment of the field's search area relative to the rectangle enclosing the name. The value depends on the value of the **Field Position** field:

* If the field is positioned to the right or to the left of the name, its search area can be aligned by the top or bottom boundary, or centered.
* If the field is positioned above or below the name, its search area can be aligned by the left or right boundary, or centered.

**Detect indent size** is a flag that specifies whether a [White Gap](/flexi-capture/fls/template/white-gap) element is used to detect the distance between the field and its name.

If this option is cleared, the search area for the distance begins from the value specified in the **Minimum space** field. Otherwise, an auxiliary [White Gap](/flexi-capture/fls/template/white-gap) element is generated starting from this distance, and the search area begins after this element.

### <a id="field" />Field search constraints

The search constraints for a field are specified on the **Field** tab.

<Frame>
  <img src="https://mintcdn.com/abbyy/fmgRWFNHKYN2MLSg/images/flexi-capture/fls/Field_tab.gif?fit=max&auto=format&n=fmgRWFNHKYN2MLSg&q=85&s=6a39f4dae9ab5aa3f0a47d04e024131f" alt="Screenshot of the Field tab of the Labeled Field element's Properties dialog box in ABBYY FlexiLayout Studio, showing the Field Content type and its search constraints." width="431" height="454" data-path="images/flexi-capture/fls/Field_tab.gif" />
</Frame>

**Field Content** specifies the type of the field's contents.

Depending on the type of the field, the **Field** tab can include additional search constraints:

| Field Content type   | Additional constraints                                                                                                                                                                                                                                                                              |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fixed variants**   | Same as the [Static Text](/flexi-capture/fls/template/static-text) type, with the same properties.                                                                                                                                                                                                  |
| **Number**           | **Value interval** – the range of possible values, from -2147483648 to 2147483647. **Signs and Separators** – **Take sign into account** (the number can have a sign) and **Can be fractional** (the number can include a fractional part).                                                         |
| **Currency**         | **Currency names** – identical to the [Currency](/flexi-capture/fls/template/currency) type's property of the same name.                                                                                                                                                                            |
| **Date**             | Same as the [Date](/flexi-capture/fls/template/date) type, with the same properties.                                                                                                                                                                                                                |
| **Phone**            | **Min number of digits** and **Max number of digits** – identical to the [Phone](/flexi-capture/fls/template/phone) type's properties of the same names.                                                                                                                                            |
| **Character String** | **Alphabet** – the set of allowed characters (same as the [Character String](/flexi-capture/fls/template/character-chain) type). **Regular expression** – the search pattern (same as the Character String type). **Min length** and **Max length** – the minimum and maximum length of the string. |

## Related topics

* [Create, copy, and delete elements](/flexi-capture/fls/template/elements-simple)
* [An overview of element properties](/flexi-capture/fls/template/elements-properties)
* [Search area](/flexi-capture/fls/template/search-constraints)
* [Labeled Field](/flexi-capture/fls/language/labeled-field-language)
