Skip to content

GroupField

Defined in: packages/core/src/fields/group/types.ts:77

Resolved configuration for a group() field, after all defaults are applied.

This is the type field input components and validator functions receive. interfaceType is a computed TypeScript object-type string built from the sub-fields (e.g. "{ title: string; description?: string }"), used by generateVexTypes to emit accurately-typed document interfaces.

  • GroupFieldInput for the user-facing input type
  • group for the config function that produces this type

TFieldMeta extends object = { }

admin: FieldAdminConfig

Defined in: packages/core/src/fields/group/types.ts:86

Resolved admin UI configuration with all defaults applied.

BaseField.admin


defaultOpen: boolean

Defined in: packages/core/src/fields/group/types.ts:109

Whether the accordion fieldset starts open in the admin form.

Resolved value after defaults — always true unless explicitly set false.


defaultValue: Record<string, unknown>

Defined in: packages/core/src/fields/group/types.ts:103

Pre-filled value shown when creating a new document.

BaseField.defaultValue


optional description?: string

Defined in: packages/core/src/fields/baseTypes.ts:252

Semantic description of the field. Used in three places:

  1. Helper text rendered below the field input in the admin form UI.
  2. As the Zod .meta({ description }) value for form validation.
  3. As the JSDoc comment on the generated document interface property.

To write a separate JSDoc comment, use interfaceDescription in addition.

BaseField.description


fields: Record<string, AdminField>

Defined in: packages/core/src/fields/group/types.ts:93

Sub-fields that form the object’s shape.

Each sub-field retains its own required, label, and admin settings. Convex and Zod validators are generated per-field respecting those settings.


optional index?: string

Defined in: packages/core/src/fields/baseTypes.ts:256

Convex index name for this field.

BaseField.index


optional interfaceDescription?: string

Defined in: packages/core/src/fields/baseTypes.ts:254

The JSDoc comment on the generated document interface property

BaseField.interfaceDescription


optional interfaceName?: string

Defined in: packages/core/src/fields/group/types.ts:101


interfaceType: string

Defined in: packages/core/src/fields/group/types.ts:100

Computed TypeScript object-type string for generateVexTypes.

Built from sub-fields in group() — e.g. "{ title: string; description?: string }". Automatically reflects nested groups or arrays within the sub-fields.

BaseField.interfaceType


label: string

Defined in: packages/core/src/fields/group/types.ts:82

Display label shown in the admin form. Always set — inferred from field key if not provided.

BaseField.label


meta: TFieldMeta

Defined in: packages/core/src/fields/baseTypes.ts:259

BaseField.meta


required: boolean

Defined in: packages/core/src/fields/group/types.ts:84

Whether this field is required in the database schema.

BaseField.required


readonly type: "group"

Defined in: packages/core/src/fields/group/types.ts:80