---
title: "Invalid Placeholder"
description: "Placeholder text in the document names a place that you did not define. Add a place with that key, or fix the placeholder text."
canonical: "https://signatureapi.com/docs/v1/errors/invalid-placeholder"
source: "https://signatureapi.com/docs/v1/errors/invalid-placeholder.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T11:41:57Z"
---

# Invalid Placeholder

Placeholder text in the document names a place that you did not define. Add a place with that key, or fix the placeholder text.

_Last verified against API version 1.18.0._

## What Happened

The document text has a placeholder such as `[[client_signs_here]]` whose name does not match the `key` of any place defined for the document. The `detail` property names the placeholder.

## Example response

```json 422 Unprocessable Content (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/invalid-placeholder",
  "title": "Invalid Placeholder",
  "status": 422,
  "detail": "The placeholder \"client_signs_here\" refers to a non-existent place in the document. Please ensure that the placeholder's name corresponds to a valid place_key defined in the document's set of Places."
}
```

## How to Fix

- Add a place with the placeholder name as its `key` to the `places` array of the document.
- Check for typos and casing differences between the placeholder text and the place `key`.
- Or remove the placeholder text from the document.
- See [Placeholders](https://signatureapi.com/docs/api/resources/places/positioning#placeholders) for how placeholders map to places.

Still stuck? [Contact support](https://signatureapi.com/support).
