---
title: "Instant JSON schema for PDF form values | Nutrient"
canonical_url: "https://www.nutrient.io/guides/web/json/schema/form-field-values/"
md_url: "https://www.nutrient.io/guides/web/json/schema/form-field-values.md"
last_updated: "2026-05-15T19:10:05.084Z"
description: "Discover how to sync PDF form field values across devices using the Instant JSON schema and best practices for implementation."
---

# Sync PDF form field values using Instant JSON

<!-- Common header for Instant JSON Schema articles -->

## Types

This section explains how to use type declarations in Instant JSON records.

The optional keys are specified as follows:

```js

{ optionalKey?: value; }

```

To reduce payload size, omit optional keys when their values are undefined.

## Form field values

Form field values were added as new Instant types to sync form field values across different devices. The `name` of a form field value must always be the _fully qualified name_ of a PDF form field:

### JSON

```json

// Example of the Instant JSON schema of a form field value:
{
	"name": "Client name",
	"type": "pspdfkit/form-field-value",
	"v": 1,
	"value": "PSPDFKit"
}

```

### JAVASCRIPT

```js

declare type FormFieldValue = {
	v: 1,
	type: 'pspdfkit/form-field-value',
	name: string,
	// Multiple values are allowed for combo boxes, list boxes, and checkboxes.
	value?: string | Array<string>,
};

```

---

## Related pages

- [Understanding Instant JSON action types](/guides/web/json/schema/actions.md)
- [Create and manage PDF bookmarks with Instant JSON](/guides/web/json/schema/bookmarks.md)
- [Streamline document discussions with Instant Comments](/guides/web/json/schema/comments.md)
- [Understanding Instant JSON attachments and schemas](/guides/web/json/schema/file-attachments.md)
- [Instant JSON format for PDF annotations explained](/guides/web/json/schema/annotations.md)
- [Effective guidelines for PDF form field types](/guides/web/json/schema/form-fields.md)