> ## Documentation Index
> Fetch the complete documentation index at: https://docs.affinda.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.affinda.com/feedback

```json
{
  "path": "/configuration/field-configuration",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# General Field Configuration

> Configure field properties in Affinda such as data types, required flags, default values, and parsing rules so extracted data matches your downstream schema.

Field configuration settings allow users to customize how data is extracted, processed, and displayed in Affinda's platform. These settings ensure the extracted data meets specific requirements and can be easily integrated into downstream workflows.

Field configuration options can be accessed by Workspace Owners and Admins by clicking 'Configure Fields' in the top right corner of the document validation view.

## Detailed guide for Schema Design

<CardGroup cols={1}>
  <Card title="Schema Design" href="/academy/schema-design">
    Click here for Affinda Academy tutorial
  </Card>
</CardGroup>

## Basic Configuration

### Field Name

The field name represents the label for the extracted data in the validation UI. It is user-defined and helps the model in extracting the field from documents; as such, it is important to have clear and relevant field names.

### Field Description

Users may optionally enhance the model's predictions by providing additional context, such as how the data is typically labelled and where it appears on the page.

<Tip>
  **Adding more documents** is the recommended way to enhance model accuracy. However, a clear field description can also improve extraction results
</Tip>

## Data Types

Your field's data type determines how extracted values are processed and standardized. Different data types are available to ensure that structured and unstructured data is correctly categorized. The selected data type influences the structure of the data and the post-processing logic applied to extracted values, ensuring consistency and accuracy.

<Card title="Standard Data Types" href="/configuration/standard-fields">
  Text, Numbers, Dates, Location, Phone Number, URLs
</Card>

<Card title="Structures" href="/configuration/group-table-fields">
  Groups and Tables
</Card>

<Card title="Picklists" href="/configuration/picklists">
  Options and Data Source
</Card>

<Card title="Checkboxes" href="/configuration/checkboxes">
  Labels and True/False
</Card>

<Card title="Image Fields" href="/configuration/images">
  Signatures, Seals, and Headshots
</Card>

<Warning>
  If the raw data extracted from the document is unable to be logically parsed into a format consistent with the data type selected, no parsed value will be returned. Edit the annotation to improve extraction accuracy, or in the case where the bounding box is correct, edit the value directly by typing the correct value
</Warning>

## Basic Field Settings

### Enabling Fields

This setting determines whether the field should be predicted and visible in the extracted output.  Users can toggle this option depending on whether they want the model to extract and display the field.

Disabling a field instead of deleting it lets the model keep all previously validated annotations and automatically restores them when the field is re‑enabled.

<img className="block dark:hidden border-2 border-gray-300 rounded-lg" src="https://mintcdn.com/affinda-44/8O48gu_z8QeuNsDM/images/disablefieldslight.png?fit=max&auto=format&n=8O48gu_z8QeuNsDM&q=85&s=8c961aac4e986971a326d89c335d1401" alt="Disable Fields" style={{ width:"72%" }} width="2420" height="912" data-path="images/disablefieldslight.png" />

<img className="hidden dark:block border-2 border-gray-300 rounded-lg" src="https://mintcdn.com/affinda-44/8O48gu_z8QeuNsDM/images/disablefieldsdark.png?fit=max&auto=format&n=8O48gu_z8QeuNsDM&q=85&s=e34c2ced71eeec2bd0cea473c620a95e" alt="Disable Fields" style={{ width:"72%" }} width="2424" height="900" data-path="images/disablefieldsdark.png" />

### Multiple Values

Enable multiple predictions only when a field can have **multiple distinct values** within a single document. Examples include:

* Line item tables on an Invoice
* Parties or Signatories in a Legal Contract
* Transactions in a Bank Statement

Enabling multiple values where you would generally not expect multiple distinct values in a document can reduce model accuracy (by overpredicting values) or risk noise and confusion in review workflows due to the presence of duplicates.

<Tip>
  **Rule of thumb:** if there should only be one real value (even if it appears multiple times on the same document), stick to a single value. Only enable **multiple values** when the document structurally allows or expects multiple *distinct* values.
</Tip>

## Advanced Field Settings

### No rectangles

Used when a field value does not explicitly appear in the document but can be inferred through reasoning.

### Manual entry only

The field will not be predicted by the model and can only be entered manually.

### Slug

Defines the unique label used for the field in the API response.

## Re-parsing after changes to the Schema

When you make changes to the Document Types configuration, any documents that were parsed previously (both confirmed and documents in review) need to be re-parsed.

The Affinda app identifies documents that should be re-parsed, indicated by the reparse button turning orange in the top right-hand corner when opening the document in the Document Validation View. Clicking on this button will update the extraction to the latest document type configuration.
