---
title: "Cannot Populate Template"
description: "The data could not be merged into the DOCX document. Check the detail for the missing or mismatched merge field and fix the document's data."
canonical: "https://signatureapi.com/docs/v1/errors/cannot-populate-template"
source: "https://signatureapi.com/docs/v1/errors/cannot-populate-template.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T11:41:57Z"
---

# Cannot Populate Template

The data could not be merged into the DOCX document. Check the detail for the missing or mismatched merge field and fix the document's data.

_Last verified against API version 1.18.0._

## What Happened

SignatureAPI could not merge the document's `data` into the [DOCX document](https://signatureapi.com/docs/api/resources/documents/templates). The usual cause is a merge field in the document that has no matching value in `data`. The `detail` property names the document by its position in the `documents` array, such as `documents[0]`, and says what went wrong.

## Example response

```json 422 Unprocessable Content (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/cannot-populate-template",
  "title": "Could Not Populate Template",
  "status": 422,
  "detail": "documents[0] could not be merged with the data: the data has no value for the merge field position"
}
```

## How to Fix

- Read the `detail` to find the missing or mismatched field.
- Give every [field](https://signatureapi.com/docs/api/resources/documents/templates#fields) and [conditional](https://signatureapi.com/docs/api/resources/documents/templates#conditionals) in the document a matching entry in `data`.
- Field names are case-sensitive. Make sure each name in the document matches its key in `data` exactly.
- Send conditional values as the type the document expects, for example the boolean `true` and not the string `"true"`.

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