Skip to content

JsonField

Defined in: packages/core/src/fields/json/types.ts:66

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

This is the type that framework adapters and field components receive — fieldDef in FieldComponentProps<JsonField> and CellComponentProps<JsonField> is this type.

  • JsonFieldInput for the user-facing input type
  • json for the config function that produces this type

TCollectionSlug extends VexResourceSlug = VexResourceSlug

TFieldMeta extends BaseFieldMeta = BaseFieldMeta

admin: FieldAdminConfig<TCollectionSlug>

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

Resolved admin UI configuration with all defaults applied.

BaseField.admin


optional defaultValue?: unknown

Defined in: packages/core/src/fields/json/types.ts:75

Pre-filled value shown in the admin form when creating a new field. Does not apply to database values.

BaseField.defaultValue


optional description?: string

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

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


optional index?: ResolvedFieldIndexConfigInput

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

Convex index name for this field, or the object form for a compound index.

BaseField.index


optional interfaceDescription?: string

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

The JSDoc comment on the generated document interface property

BaseField.interfaceDescription


interfaceType: string

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

TypeScript type string written to generated document interfaces (e.g. "string", "number", "string[]").

BaseField.interfaceType


label: string

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

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

BaseField.label


meta: TFieldMeta

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

BaseField.meta


required: boolean

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

Whether this field is required in the database schema.

BaseField.required


readonly type: "json"

Defined in: packages/core/src/fields/json/types.ts:70

optional validate(props): void | Promise<void>

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

Server-only async validation with value typed as unknown.

FieldValidateProps<TCollectionSlug, unknown>

void | Promise<void>

FieldValidate

BaseField.validate