# Mail Merge

> Turn templates and JSON data into PDF or DOCX with the document/merge Web API: merge fields, blocks, images, HTML, culture, settings and the template editor.

- **Product:** ReportingCloud
- **Section:** Documentation
- **Kind:** Topic
- **Path:** ReportingCloud > Mail Merge
- **Web URL:** https://docs.textcontrol.com/reporting-cloud/mail-merge/
- **LLMs URL:** https://docs.textcontrol.com/reporting-cloud/mail-merge/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/reporting-cloud/mail-merge/llms-full.txt

---

## On This Page

- [How Mail Merge Works](https://docs.textcontrol.com/reporting-cloud/mail-merge/#how-mail-merge-works)
- [Find the Right Page](https://docs.textcontrol.com/reporting-cloud/mail-merge/#find-the-right-page)
- [Where to Start](https://docs.textcontrol.com/reporting-cloud/mail-merge/#where-to-start)
- [Pages in This Section](https://docs.textcontrol.com/reporting-cloud/mail-merge/#pages-in-this-section)

---

## In This Section

- [Merge Blocks](https://docs.textcontrol.com/reporting-cloud/mail-merge/blocks/llms.txt): Repeat a table row for each invoice line item with a merge block named after a JSON array: the template editor, removeEmptyBlocks and templates/info.
- [Conditional Blocks](https://docs.textcontrol.com/reporting-cloud/mail-merge/conditional-content/llms.txt): Show or remove a template section depending on the merge data: merge blocks bound to objects, removeEmptyBlocks and curl and .NET samples for document/merge.
- [Culture](https://docs.textcontrol.com/reporting-cloud/mail-merge/culture/llms.txt): Format currency values and long dates for a country with the culture merge setting: language culture names such as de-DE, numeric format C, curl and .NET.
- [Merge Data](https://docs.textcontrol.com/reporting-cloud/mail-merge/data-sources/llms.txt): Structure the JSON mergeData array of a merge: records, values, arrays for merge blocks, nested objects and the serialization by the .NET and PHP SDKs.
- [Merge Fields](https://docs.textcontrol.com/reporting-cloud/mail-merge/fields/llms.txt): Name merge fields after JSON keys, use dot notation for nested objects, set numeric and date formats, list fields with templates/info, remove empty ones.
- [HTML Content](https://docs.textcontrol.com/reporting-cloud/mail-merge/html-content/llms.txt): Merge formatted HTML with strong, em and u tags into merge fields with the mergeHtml setting: the html wrapper, kept font settings and curl and .NET samples.
- [Images](https://docs.textcontrol.com/reporting-cloud/mail-merge/images/llms.txt): Merge JPG, PNG, BMP or GIF images from Base64 JSON data into image placeholders with document/merge: template editor steps, curl, .NET and removeEmptyImages.
- [Nested Blocks](https://docs.textcontrol.com/reporting-cloud/mail-merge/nested-blocks/llms.txt): Build a sales report with a merge block inside a merge block: nested JSON arrays, a datasource excerpt, the template editor, a curl request and the .NET SDK.
- [Overview](https://docs.textcontrol.com/reporting-cloud/mail-merge/overview/llms.txt): Build the POST /v1/document/merge request: templateName, returnFormat, append and test, the JSON MergeBody, status codes, stored or sent templates and SDKs.
- [Merge Settings](https://docs.textcontrol.com/reporting-cloud/mail-merge/settings/llms.txt): Every property of the MergeSettings object of document/merge: remove options, mergeHtml, culture, document properties, userPassword, defaults and SDK names.
- [Template Design](https://docs.textcontrol.com/reporting-cloud/mail-merge/template-design/llms.txt): Design templates for your data: sample JSON from .NET classes, a datasource excerpt, an invoice template built in the editor and the fonts it can use.

---

## Nearby

- **Previous:** [Transactions and Statistics](https://docs.textcontrol.com/reporting-cloud/portal/statistics/llms.txt)
- **Next:** [Overview](https://docs.textcontrol.com/reporting-cloud/mail-merge/overview/llms.txt)
