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

# Image field

> Extract image regions from documents (signatures, stamps, identity photos) and configure how the images are saved on export.

An Image field lets you save parts of documents as pictures — for example, identity photos, signatures, or stamps.

## Add an Image field

Click **Add Image** in the toolbar. A new Image field appears in the data form.

<Warning>
  Image fields cannot be trained. For every document with an Image field, you must set the image region during [manual review](/vantage/documentation/runtime/manual-review/manual-review) or via a [Custom activity](/vantage/documentation/skill-designer/process/custom-activity) script.
</Warning>

<Note>
  An Image field cannot have more than one region. To extract multiple images, enable **Allow multiple items** and add one image per instance.
</Note>

## General properties

| Property                 | Description                                                                                                                            |
| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------- |
| **Field name**           | Unique within the skill. Cannot contain: `. , / : * ? " < > \|`. Maximum length: 90 characters.                                        |
| **Required field**       | If enabled and the field is empty after extraction, the document goes to manual review with a rule error.                              |
| **Allow multiple items** | Whether the field can have multiple instances (for example, extracting signatures from each party on an agreement as separate images). |

## Access extracted images

During data export, Vantage extracts each image using its region coordinates and saves it as a JPG. You can access extracted images the same way as other extracted data:

* **Vantage API** — Retrieve extracted images alongside other field values.
* **Custom activity or Output activity scripts** — The [Field](/vantage/documentation/skill-designer/process/custom-activity/field) object exposes `Value` (the filename) and `Image` (the binary contents).
* **Shared folder export (Output activity)** — The JSON export includes the image filename in each image field's `value` key. Image files are placed in a subfolder named after the JSON file.

### File naming

During export, Vantage names each image file based on the field and its position in the skill hierarchy:

| Field configuration                                | Filename                             |
| :------------------------------------------------- | :----------------------------------- |
| Top-level field `Signature`                        | `Signature.jpg`                      |
| Multiple instances of `Signature`                  | `Signature_1.jpg`, `Signature_2.jpg` |
| Field nested in `Group1` > `Group2` as `Signature` | `Group1_Group2_Signature.jpg`        |

<Note>
  If the resulting filename would exceed 256 characters (including separators, instance numbers, and the `.jpg` extension), Vantage falls back to `Field_{guid}.jpg`, where `{guid}` is the GUID of the image field.
</Note>

## Related topics

* [Custom activity](/vantage/documentation/skill-designer/process/custom-activity/custom-activity)
* [Output activity](/vantage/documentation/skill-designer/process/output-activity/output-activity)
* [Label documents in Skill Designer](/vantage/documentation/skill-designer/document/labeling-documents)
* [Add fields](/vantage/documentation/skill-designer/document/adding-fields/adding-fields)