# Signature

Captured signature data

Canonical URL: https://docs.paradoc.dev/schemas/primitives/signature/

A Signature is a structured primitive that represents the data captured when a party signs a [Form](/schemas/artifacts/form), including the signature image/data, timestamp, capture method, and optional metadata.

## Properties

| Name | Type | Description |
| --- | --- | --- |
| `image?` | `string` | Base64-encoded signature image or data URI |
| `timestamp` | `string` | ISO 8601 UTC date-time (ending in `Z`) when the signature was captured |
| `method` | `'drawn' \| 'typed' \| 'uploaded' \| 'certificate'` | Method used to capture the signature |
| `type?` | `'signature' \| 'initials'` | Whether this is a full signature or initials |
| `metadata?` | `Record<string, unknown>` | Additional metadata (IP address, device info, etc.) |

### Signature Methods

| Method        | Description                                |
| ------------- | ------------------------------------------ |
| `drawn`       | Signature drawn on screen (touch or mouse) |
| `typed`       | Name typed and converted to signature font |
| `uploaded`    | Signature image uploaded from file         |
| `certificate` | Digital certificate-based signature        |

### Signature Types

| Type        | Description              |
| ----------- | ------------------------ |
| `signature` | Full signature (default) |
| `initials`  | Initials only            |

## Examples



**YAML**

```yaml
image: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
timestamp: "2024-01-15T14:45:00Z"
method: drawn
type: signature
metadata:
  ipAddress: "192.168.1.100"
```

**JSON**

```json
{
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "timestamp": "2024-01-15T14:45:00Z",
  "method": "drawn",
  "type": "signature",
  "metadata": {
    "ipAddress": "192.168.1.100"
  }
}
```

## Related

* [FormSignature](/schemas/artifacts/form/party) - Design-time signature requirements (in FormParty)
* [FormParty](/schemas/artifacts/form/party) - Party role definitions
* [Signing](/sdk/artifacts/form/signing) - Runtime signing flow, captures, and attestations