> ## 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.

# Group field

> Add a Group field to a Document skill to bundle related fields (like an address or contact block), and configure repeating groups.

A Group field bundles data related to a single entity — for example, a person or a company. It can contain fields of any type.

## Add a Group

To add a group, click **Add Group** in the toolbar, or press **Ctrl + G**. An empty group appears in the data form. Click the **First group item** placeholder to add the first field to the group.

<Frame caption="Empty group in the data form">
  <img src="https://mintcdn.com/abbyy/2P9PUHDOk18e8aR8/images/vantage/skill-designer/screen_docskill_fields_emptygroup.png?fit=max&auto=format&n=2P9PUHDOk18e8aR8&q=85&s=d9dd9ff347b4119075106c45e4665868" alt="Empty group with a First group item placeholder" style={{ width: "42%" }} width="412" height="140" data-path="images/vantage/skill-designer/screen_docskill_fields_emptygroup.png" />
</Frame>

## Add fields to a Group

When a group is in focus, any new field you add (via the toolbar or by drawing a region on the document) is placed inside the group. Select a field inside a group to switch focus to it.

Fields inside a group use the same properties as standalone fields. See [Text field](/vantage/documentation/skill-designer/document/adding-fields/text) and the other field-type topics.

## Rename a Group

Double-click the group name in the data form and type the new name.

## Expand and collapse a Group

Click a group name to expand or collapse it. When a group is collapsed, the value of its first field appears beneath the group name.

A group auto-expands when its fields contain low-confidence characters or rule errors, and auto-collapses otherwise.

<Frame caption="Expanded group">
  <img src="https://mintcdn.com/abbyy/2P9PUHDOk18e8aR8/images/vantage/skill-designer/screen_docskill_fields_expandedgroup.png?fit=max&auto=format&n=2P9PUHDOk18e8aR8&q=85&s=aa35331633e05a7979a33128cea4e892" alt="Expanded group showing all fields" style={{ width: "52%" }} width="485" height="243" data-path="images/vantage/skill-designer/screen_docskill_fields_expandedgroup.png" />
</Frame>

<Frame caption="Collapsed group">
  <img src="https://mintcdn.com/abbyy/2P9PUHDOk18e8aR8/images/vantage/skill-designer/screen_docskill_fields_collapsedgroup.png?fit=max&auto=format&n=2P9PUHDOk18e8aR8&q=85&s=b9e7f22bfe54cdd4550b06b7da51dc3b" alt="Collapsed group showing only the first field value" style={{ width: "45%" }} width="460" height="76" data-path="images/vantage/skill-designer/screen_docskill_fields_collapsedgroup.png" />
</Frame>

## General properties

| Property                 | Description                                                                                                                                 |
| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |
| **Field name**           | Unique within the skill. Cannot contain: `. , / : * ? " < > \|`. Maximum length: 90 characters.                                             |
| **Allow multiple items** | Whether the group can repeat (for example, multiple children or accounts). A repeating group can contain nested groups, tables, and fields. |

<Note>
  The maximum nesting depth is 3. A level-1 repeating group can contain nested repeating or non-repeating elements. A level-2 repeating group cannot contain child repeating groups, repeating fields, or tables.
</Note>

## Enable repeating Groups

<Steps>
  <Step title="Open group settings">Click the settings button near the group.</Step>
  <Step title="Open advanced settings">Click **Advanced**.</Step>
  <Step title="Enable Allow multiple items">Select **Allow multiple items**.</Step>
</Steps>

<Frame caption="Allow multiple items option in group settings">
  <img src="https://mintcdn.com/abbyy/2P9PUHDOk18e8aR8/images/vantage/skill-designer/screen_docskill_fields_allowmultipleitems.png?fit=max&auto=format&n=2P9PUHDOk18e8aR8&q=85&s=89dfa93b5e4efd54f115b2832afe180d" alt="Advanced group settings with Allow multiple items enabled" style={{ width: "59%" }} width="720" height="666" data-path="images/vantage/skill-designer/screen_docskill_fields_allowmultipleitems.png" />
</Frame>

<Warning>
  If you turn off **Allow multiple items**, all instances except the first are deleted.
</Warning>

### Add a new item

Click **Add *\[group-name]* item**, where *\[group-name]* is the name of your group.

<Frame caption="Add a new repeating-group item">
  <img src="https://mintcdn.com/abbyy/2P9PUHDOk18e8aR8/images/vantage/skill-designer/screen_docskill_fields_addnewitem.png?fit=max&auto=format&n=2P9PUHDOk18e8aR8&q=85&s=d2dfd19714ad64ae2f3c55ea907fc089" alt="Add new item button for a repeating group" style={{ width: "39%" }} width="456" height="188" data-path="images/vantage/skill-designer/screen_docskill_fields_addnewitem.png" />
</Frame>

## Related topics

* [Text field](/vantage/documentation/skill-designer/document/adding-fields/text)
* [Table field](/vantage/documentation/skill-designer/document/adding-fields/table)
* [Label documents in Skill Designer](/vantage/documentation/skill-designer/document/labeling-documents)
* [Add fields](/vantage/documentation/skill-designer/document/adding-fields/adding-fields)
