> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# FileFieldLocation

Defines the precise positioning and sizing of a field within the PDF document. Fields can be positioned
using absolute coordinates or by searching for specific text anchors within the document.

#### Properties

| Name           | Type    | Description |                                                                                                                                                                                                                               |
| -------------- | ------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **PageNumber** | Integer | Null        | <p>The page number where this field should be placed (1-based indexing). If not specified, the field may be positioned based on search criteria across all pages.</p>                                                         |
| **Search**     | String  | Null        | <p>Text string to search for in the document to anchor the field position. When specified, the field will be positioned relative to this text rather than using absolute coordinates.</p>                                     |
| **Occurence**  | Integer | Null        | <p>When using search text positioning, specifies which occurrence of the search text to use if the text appears multiple times on the page or document (1-based indexing).</p>                                                |
| **Top**        | Integer | Null        | <p>Vertical position from the top of the page in pixels or points. Used for absolute positioning or as an offset when combined with search positioning.</p>                                                                   |
| **Right**      | Integer | Null        | <p>Horizontal position from the right edge of the page in pixels or points. Typically used for right-aligned field positioning.</p>                                                                                           |
| **Bottom**     | Integer | Null        | <p>Vertical position from the bottom of the page in pixels or points. Can be used instead of or in combination with the top property for precise vertical positioning.</p>                                                    |
| **Left**       | Integer | Null        | <p>Horizontal position from the left edge of the page in pixels or points. The most common way to specify horizontal field positioning.</p>                                                                                   |
| **Width**      | Integer | Null        | <p>Width of the field in pixels or points. Determines how much horizontal space the field occupies and affects text wrapping for text fields.</p> <p>For signature and seal fields we suggest a width of 140.</p>             |
| **Height**     | Integer | Null        | <p>Height of the field in pixels or points. Determines how much vertical space the field occupies and affects text size and line spacing for text fields.</p> <p>For signature and seal fields we suggest a height of 70.</p> |