# AdaptableFormFieldGroup

Canonical page: https://www.adaptabletools.com/docs/reference/adaptableformfieldgroup

Logical grouping of related fields, with an optional title and
description. Use to break long forms into visually distinct sections.

Groups behave like fields when it comes to `hidden`: a hidden group is
not rendered and its child fields are excluded from validation. They
are otherwise transparent - each child field continues to drive its
own value, validation, and `onValueChange` lifecycle.

In the `inline` layout the group's title/description are not rendered
(the layout is too compact for sectioning). The child fields are
laid out inline alongside the rest.

```ts title="TypeScript"
export interface AdaptableFormFieldGroup 
```

## Properties

| Property | Type | Description |
| --- | --- | --- |
| [description](https://www.adaptabletools.com/docs/reference/adaptableformfieldgroup.md#description) | `string` | Optional description rendered immediately below the title. |
| [fields](https://www.adaptabletools.com/docs/reference/adaptableformfieldgroup.md#fields) | `(`[`AdaptableFormField`](https://www.adaptabletools.com/docs/reference/adaptableformfield.md)` \| `[`AdaptableFormField`](https://www.adaptabletools.com/docs/reference/adaptableformfield.md)`[])[]` | Fields contained in the group. Inner items may be a single field or<br/>an array of fields (rendered side-by-side on the same row, exactly<br/>like the top-level shorthand). |
| [hidden](https://www.adaptabletools.com/docs/reference/adaptableformfieldgroup.md#hidden) | `boolean \| ((formData: `[`AdaptableFormData`](https://www.adaptabletools.com/docs/reference/adaptableformdata.md)`, context: `[`BaseContext`](https://www.adaptabletools.com/docs/reference/basecontext.md)`) => boolean)` | Hide the entire group. Either a boolean or a function evaluated<br/>against the current form data. Hidden groups skip rendering and<br/>exclude their children from validation. |
| [kind](https://www.adaptabletools.com/docs/reference/adaptableformfieldgroup.md#kind) | `'group'` | Discriminator - identifies the item as a group rather than a field. |
| [title](https://www.adaptabletools.com/docs/reference/adaptableformfieldgroup.md#title) | `string` | Optional title rendered as the section header. |

## Property Details

### description

Optional description rendered immediately below the title.

```ts title="TypeScript"
description?: string;
```

###### Property Value

`string`

### fields

Fields contained in the group. Inner items may be a single field or
an array of fields (rendered side-by-side on the same row, exactly
like the top-level shorthand).

```ts title="TypeScript"
fields: (AdaptableFormField | AdaptableFormField[])[];
```

###### Property Value

`(`[`AdaptableFormField`](https://www.adaptabletools.com/docs/reference/adaptableformfield.md)` | `[`AdaptableFormField`](https://www.adaptabletools.com/docs/reference/adaptableformfield.md)`[])[]`

### hidden

Hide the entire group. Either a boolean or a function evaluated
against the current form data. Hidden groups skip rendering and
exclude their children from validation.

```ts title="TypeScript"
hidden?: boolean | ((formData: AdaptableFormData, context: BaseContext) => boolean);
```

###### Property Value

`boolean | ((formData: `[`AdaptableFormData`](https://www.adaptabletools.com/docs/reference/adaptableformdata.md)`, context: `[`BaseContext`](https://www.adaptabletools.com/docs/reference/basecontext.md)`) => boolean)`

### kind

Discriminator - identifies the item as a group rather than a field.

```ts title="TypeScript"
kind: 'group';
```

###### Property Value

`'group'`

### title

Optional title rendered as the section header.

```ts title="TypeScript"
title?: string;
```

###### Property Value

`string`