---
title: "Field Group Component"
slug: "field-group-component"
updated: 2026-09-15T18:02:24Z
published: 2026-09-15T18:02:24Z
canonical: "docs.unqork.io/field-group-component"
---

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

# Field Group Component

The Field Group component groups related input fields with a shared visual boundary. Use it to visually organize sections of a form without the modal or import capabilities of the Panel component.

> **How to read settings tables**
> 
> The tables below describe each configurable option as it displays in the UnqorkAI platform. Values are formatted as follows: `inline code` — a value to type exactly as shown | **Bold** — a value selected from a drop-down, radio button, tab, or choice chip | **ON**/**OFF** — toggle state | ✓ — checkbox checked | ☐ — checkbox unchecked

## General Settings

| Setting | Field | Type | Default | Description |
| --- | --- | --- | --- | --- |
| Property ID | `key` | Text input | `fg` | The unique identifier for this component instance. |

## Display Settings

### Field Text

| Setting | Field | Type | Default | Description |
| --- | --- | --- | --- | --- |
| Canvas Label Text | `title` | Text input | — | Identifies the component on the Module Builder canvas. Does not display. |

### Default State Options

| Setting | Field | Type | Default | Description |
| --- | --- | --- | --- | --- |
| Disable All Nested Fields | `disabled` | Toggle | OFF | Prevents end-users from interacting with any components inside the group. |
| Hide All Nested Fields | `hidden` | Toggle | OFF | Hides all components inside the group from end-users. |

## Advanced Settings

### Additional Styling

| Setting | Field | Type | Default | Description |
| --- | --- | --- | --- | --- |
| Custom CSS Class | `customClass` | Text input | — | A CSS class applied to the Field Group component for custom styling. |

## Accessibility Settings

For details on each setting, its options, and when to use it, see [Accessibility Settings Reference](/unqorkai/docs/accessibility-settings-reference).

| Setting | Field | Type | Default | Description |
| --- | --- | --- | --- | --- |
| ARIA Label | `ariaLabelOption` | Drop-down | **None** | Sets how to label this element for screen readers. Options include: **None**, **Custom Label**, or **Reference Label(s)**. |
| ARIA Description | `ariaDescriptionOption` | Drop-down | **None** | Sets how to provide additional context for screen readers. Options include: **None**, **Custom Description**, or **Reference Description(s)**. |
| ARIA Role | `ariaRole` | Drop-down | — | Defines the semantic role of the element for assistive technologies. See [Accessibility Settings Reference](/unqorkai/docs/accessibility-settings-reference) for the full list of available roles. |
| Announce Live Changes | `ariaLive` | Drop-down | OFF | Controls how screen readers announce dynamic content updates. Options include: **Off**, **Polite**, or **Assertive**. |
| Hide From Screen Readers | `ariaHidden` | Toggle | OFF | Hides the element from assistive technologies without removing it from the DOM. |

### Custom ARIA Attributes

Adds additional custom ARIA attributes to the element as key-value pairs.

| Column | Field | Description |
| --- | --- | --- |
| Attribute | `key` | The ARIA attribute name (for example, `aria-label`, `aria-describedby`, and so on). |
| Value | `value` | The value for the attribute. |

## Operations Builder

This component supports the [Operations Builder](/unqorkai/docs/operations-builder) in Vega modules. When the module or panel runtime is set to **Vega (2.0)**, an **Event Handlers** section displays in the settings panel for configuring event-driven operations.

---

**Changelog**

| Date | Change |
| --- | --- |
| — | Initial publication. |

A Property ID is the unique field ID used by Unqork to track and link components in your module.

Canvas Label Text indicates the purpose of the corresponding field or component. For non-input components, the Canvas Label Text isn't end-user facing, and only appears in the .

End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.

Cascading Style Sheets (CSS) is a style sheet language used for presenting how a HTML or XML document looks to end-users.

ARIA (Accessible Rich Internet Applications) is a set of attributes used in HTML to enhance the accessibility of web content, particularly dynamic or interactive web pages, for users who rely on assistive technologies like screen readers.

Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field.

Assistive technology that reads digital text aloud for users with visual impairments or reading disabilities.

Semantic HTML uses HTML elements to clearly describe their meaning, rather than just their appearance, to structure web content for better readability and accessibility for both humans and machines.

The Document Object Model (DOM) is the data representation of objects that form the structure and content of a document on the web. The DOM represents the page.

A key-value pair is a fundamental data structure where a unique "key" is associated with a specific "value," used for organizing and retrieving data efficiently, like in dictionaries or databases.

The Vega (v 2.0.0) runtime is the next-generation engine of the UDesigner platform. Vega uses cutting-edge technologies to improve the Creator and end-user experience.

The Vega (v 2.0.0) runtime is the next-generation engine of the UDesigner platform. Vega uses cutting-edge technologies to improve the Creator and end-user experience.