---
title: "Create a Text Merge"
slug: "create-first-text-merge"
description: "Learn how to create a Text Merge in Decisions and use built-in fields to dynamically manipulate text from multiple data sources."
tags: ["text merge"]
updated: 2026-06-26T14:00:18Z
published: 2026-06-26T14:00:18Z
canonical: "documentation.decisions.com/create-first-text-merge"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Text Merge

## Overview

**Custom Text Merges** can be created in a Designer Project or Flow to merge written text and data. When a custom Text Merge is created and referenced in a **Flow**, inputs can be mapped dynamically using **Flow data**.

---

## Using a Custom Text Merge in a Flow

**Text Merges** have a Designer that acts as an interface with pre-built **Calculated Fields** and **Icons.** For data to be usable, it must be added as **Input Data**. This example will explore how to create a text merge and use it in a Flow.

1. In a Project, [create a new Flow](/version-10/docs/create-flows).
2. In the Toolbox, navigate to **Data > Text > Text Merges**. Select **[Pick or Create TextMerge]** and add it to the workspace.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778689590744.png)
3. On the **Properties** panel, click PICK OR CREATE TEXTMERGE and create a new **Text Merge**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778689652784.png)
4. The **Text Merge Designer** will open. In the **Properties** panel for the designer, add two new String inputs, One for **Name** and another for **Email Address**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778689831301.png)
5. With the inputs defined, add text into the workspace utilizing the inputs. For example, **[Name]**'s email is **[Email Address]**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778689910267.png)
6. Once the Text Merge is defined, save and close this Designer.
7. In the **Flow Designer**, two new input values appear on the step, matching the created inputs for the **Text Merge**. Define values for the inputs.
8. Under **Settings**, set **Merge Text Type** to **Plain**. Below is a brief overview of the different Merge Text Types.

| Text Type | Description |
| --- | --- |
| Plain | Outputs the Text Merge as a regular string |
| HTML | Outputs the Text Merge as HTML string |
| PDF | Outputs the Text Merge as a PDF file |
| DOC | Outputs the Text Merge as a Word document |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778690078234.png)
9. Add a [Form](/version-10/docs/create-forms) with a Label that will display the Text Merge.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778690337619.png)
10. Save and debug the Flow to view the resulting output.