> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/mutations/criando-um-documento/signature-placement.md).

# Signature Placement

Signature placement allows you to define where participant-related information will appear on the document’s pages. These elements are added through each signer’s `positions` property.

When positions are configured, the elements are automatically inserted at the specified locations after the participant completes their action. This eliminates the need to manually choose where to sign.

Placement can be configured when creating the document with `CreateDocument.`

Example:

```json
{
  "signers": [
    {
      "email": "signer@example.com",
      "action": "SIGN",
      "positions": [
        {
          "x": "5.0",
          "y": "90.0",
          "z": 1,
          "angle": 0,
          "scale": 1.0,
          "element": "SIGNATURE"
        }
      ]
    }
  ]
}
```

Each item in the `positions` array represents an element to be displayed in the document.

<table><thead><tr><th width="204.85546875">Field</th><th>Description</th></tr></thead><tbody><tr><td><code>x</code></td><td>The element’s horizontal position, expressed as a percentage of the page width.</td></tr><tr><td><code>y</code></td><td>The element’s vertical position, expressed as a percentage of the page height.</td></tr><tr><td><code>z</code></td><td>The page on which the element will be displayed.</td></tr><tr><td><code>angle</code></td><td>The element’s rotation angle.</td></tr><tr><td><code>scale</code></td><td>The element’s scale.</td></tr><tr><td><code>element</code></td><td>The type of element to insert.</td></tr></tbody></table>

The following element types are available:

<table><thead><tr><th width="172.94140625">Element</th><th>Description</th></tr></thead><tbody><tr><td><code>SIGNATURE</code></td><td>The participant’s signature.</td></tr><tr><td><code>INITIALS</code></td><td>The participant’s initials.</td></tr><tr><td><code>NAME</code></td><td>The participant’s full name.</td></tr><tr><td><code>CPF</code></td><td>The participant’s CPF number.</td></tr><tr><td><code>DATE</code></td><td>The signature date.</td></tr></tbody></table>

You can position multiple elements for the same participant:

```json
{
  "positions": [
    {
      "x": "5.0",
      "y": "90.0",
      "z": 1,
      "angle": 0,
      "scale": 1.0,
      "element": "SIGNATURE"
    },
    {
      "x": "5.0",
      "y": "95.0",
      "z": 1,
      "angle": 0,
      "scale": 1.0,
      "element": "DATE"
    }
  ]
}
```

The `x` and `y` values use percentage-based coordinates ranging from `0` to `100`, allowing the placement to remain proportional to the page dimensions.

The `angle` value represents the element’s rotation in degrees and ranges from `0` to `360`.

The `scale` value is a multiplier applied to the element’s size. The default scale is `1.0`, with a minimum of `0.5` and a maximum of `4.0`.

{% hint style="warning" %}
**Warning:** Only the document creator or the integration responsible for the document can define or modify placements. Participants cannot move, edit, or choose the location of configured elements.
{% endhint %}

{% hint style="info" %}
**Note:** If no placements are provided, the document can still be signed normally through the platform’s signing page. In this case, no elements are automatically inserted into the PDF pages.
{% endhint %}