---
title: Document fields configuration
description: "Additional document fields configuration Document data example : ``` { \"allowedFields\": { \"SIGNATURE\": [ \"SC_signature\" ], \"TEXT\": [ \"TO_text\", \"TC_text\" ] }, \"fieldConfig\": [ { \"name\": \"TC_text\", \"value\": \"New value\" }, { \"name\": \"TO_text\", \"value\": \"New readonly value\", \"readOnly\": true…"
url: "https://wiki.signatus.com/documentation/signatus-2-api/document-fields-configuration/"
updated: "2026-05-07"
category: 2. Core API services
---

# Document fields configuration

Additional document fields configuration

Document data example :

```
{
	"allowedFields": {
		"SIGNATURE": [
			"SC_signature"
		],
		"TEXT": [
			"TO_text",
			"TC_text"
		]
	},
	"fieldConfig": [
		{
			"name": "TC_text",
			"value": "New value"
		},
		{
			"name": "TO_text",
			"value": "New readonly value",
			"readOnly": true
		}
	],
	"ignoreRequired": [
		"SIGNATURE"
	],
	"fieldsBeforeSigning": "keep"
}
```

Document data description

| Name | Value | Description |
| --- | --- | --- |
| allowedFields | JSON Object | Configuration of which AcroFields will be allowed during signing. |
| allowedFields.key | String | Acrofield type. Allowed values : - TEXT, - CHECKBOX - SIGNATURE - RADIO - COMBOBOX |
| allowedFields.value | JSON Array | AcroField names |
| fieldConfig | JSON Array | Array of JSON object that describe, how the value will be set to acrofield, and and read only possibility |
| fieldConfig.name | String | AcroField name |
| fieldConfig.value | String | Acrofield value |
| fieldConfig.readOnly | boolean | AcroField read only flag |
| ignoreRequired | JSON Array | Array of strings that describes, which type of acrofields are not required to be fill in. Allowed values : - TEXT, - CHECKBOX - SIGNATURE - RADIO - COMBOBOX |
| fieldsBeforeSigning | String | PDF acrofields manipulation before pdf signing - flatten : acrofields are destroyed - readOnly : acrofields are set to read only mode - keep : acrofields mode are not changed Default : flatten |