---
title: "Append Operator"
slug: "append-operator"
updated: 2025-09-26T04:23:34Z
published: 2025-09-26T04:23:34Z
canonical: "docs.unqork.io/append-operator"
---

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

# Append Operator

UDesignerClassic Designer

The **Append operator** lets you combine values from two different fields. But the Append operator does not add the values as the [Aggregate](/v1/docs/aggregate-operator) operator does. Instead, the Append operator combines your values into one value. Suppose you want to create a unique username from a first name and last name. If you enter the first name of **Willow** and the last name of **Kusko** in separate fields, the Append operator combines the values as **WillowKusko**.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/appendOperator_thumb_0_0.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)

The Append operator is not limited to input fields. It also lets you append data tables. Let's say you collected names and birth dates in two different parts of your application. You can use the Append operator to combine them.

### Similar Data Workflow Operators

The Append operator is like the [Extend](/v1/docs/extend-operator) and [Aggregate](/v1/docs/aggregate-operator) operators. Here are the operators compared:

- **Append operator**: Combines strings or arrays together. It appends strings using concatenation and appends two arrays into one.
- **Extend operator**: Combines two objects into a single object. The Extend operator is typically used with [Group Input](/v1/docs/group-input-operator) operators to create objects with more than six fields.
- **Aggregate operator**: Performs calculations on two or more numbers. This operator supports the Sum By, Count By, Mean By, Max By, and Min By operations.

## About the Info Window

Here's a breakdown of each setting in the Append operator's Info window:

| **Setting** | Description |
| --- | --- |
| **Category** | Grayed out and non-adjustable setting indicating the operation type. |
| **Label** | Sets the label for your operator, displaying below the operator on your Data Workflow canvas. This field is optional, but set a label if you use more than one of the same operator type. A label helps you identify your operators without opening any Info windows. |
| **Preserve Argument Type** | When selected, this setting ensures the argument data type is respected when the operator executes. |

## Adding an Append Operator

In this example, you'll configure a Data Workflow and an Append operator to combine two values. First, you'll configure [Text Field](/v1/docs/text-field-component) components to serve as your inputs. Then, you'll use a Data Workflow to append the values.

### Configure the Text Field Components

Configure two [Text Field](/v1/docs/text-field-component) components to serve as your input fields. Then, configure a third to serve as the output for your Data Workflow.

1. In the Module Builder, drag and drop three **T****ext Field** components onto your canvas.
2. In the **Property ID** and **Label Text** fields for each component, enter the following:

| # | Property ID | Label Text |
| --- | --- | --- |
| 1 | firstString | First String |
| 2 | secondString | Second String |
| 3 | appendedValue | Appended Value |
3. In the **appendedValue** **T****ext Field** component, from the **Input Behavior** drop-down, select **Disable User Input**.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/appendimage textfield_thumb_0_0.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)
4. Click **Save Component** for each component as you add it.

### Configure the Data Workflow Component

Next, configure a [Data Workflow](/v1/docs/data-workflow-component) component with two Input operators that are used to bring data from the **input** **Text Field** components into the Data Workflow. Then, you'll configure an Append operator to combine the values and pass the result to an Output operator.

1. Drag and drop a **D****ata Workflow** component onto your canvas, placing it above your **appendedValue** **T****ext Field** component.
2. In the **Property ID** and **Canvas Label Text** fields, enter `dwfAppendStrings`.
3. Set the **Trigger Type** to **Watch**.

#### Configure the First Input Operator

1. Drag and drop an **I****nput** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Info |
| --- |
| Category | Input |
| Component | firstString |
| Required | Yes |
| Source | Default |

#### Configure the Second Input Operator

1. Drag and drop another **I****nput** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Info |
| --- |
| Category | Input |
| Component | secondString |
| Required | Yes |
| Source | Default |

#### Configure the Append Operator

1. Drag and drop an **A****ppend** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Info |
| --- |
| Category | Append |
| Label | Append Strings |
3. Connect the output port (right) of the **firstString** **I****nput** operator to the upper input port (left) of the **Append Strings** **A****ppend** operator.
4. Connect the output port (right) of the **secondString** **I****nput** operator to the lower input port (left) of the **Append Strings** **A****ppend** operator.

#### Configure the Output Operator

1. Drag and drop an **O****utput** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Info |
| --- |
| Category | Output |
| Component | appendedValue |
| Action | value |
3. Connect the output port (right) of the **Append Strings** **A****ppend** operator to the input port (left) of the **appendedValue****O****utput** operator.
4. Click **Save Component**.
5. **Save** your module.

Here's how the completed Data Workflow looks:

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/DATWORKFLOWAPPEND_thumb_0_0.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)

Here's how the completed example looks in the Module Builder:

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/FINALCONFIGAPPEND_thumb_0_0.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)

Preview your module in Express View and enter values into your Text Field components. As you enter your values, you can view them combined in the **Appended Value** field.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/appendoperatorfinal_thumb_0_0.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)

The **Append operator** lets you combine values from two different fields. But the Append operator does not add the values as the [Aggregate](/v1/docs/aggregate-operator) operator does. Instead, the Append operator combines your values into one value. Suppose you want to create a unique username from a first name and last name. If you enter the first name of **Willow** and the last name of **Kusko** in separate fields, the Append operator combines the values as **WillowKusko**.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_Append_Operator_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)

The Append operator is not limited to input fields. It also lets you append data tables. Let's say you collected names and birth dates in two different parts of your application. You can use the Append operator to combine them.

### Similar Data Workflow Operators

The Append operator is like the [Extend](/v1/docs/extend-operator) and [Aggregate](/v1/docs/aggregate-operator) operators. Here are the operators compared:

- **Append operator**: Combines strings or arrays together. It appends strings using concatenation and appends two arrays into one.
- **Extend operator**: Combines two objects into a single object. The Extend operator is typically used with [Group Input](/v1/docs/group-input-operator) operators to create objects with more than six fields.
- **Aggregate operator**: Performs calculations on two or more numbers. This operator supports the Sum By, Count By, Mean By, Max By, and Min By operations.

## About the Info Window

And here's a breakdown of each setting in the Append operator's Info window:

| **Setting** | Description |
| --- | --- |
| **Category** | Grayed out and non-adjustable setting indicating the operation type. |
| **Label** | Sets the label for your operator, displaying below the operator on your Data Workflow canvas. This field is optional, but set a label if you use more than one of the same operator type. A label helps you identify your operators without opening any Info windows. |
| **Preserve Argument Type** | When selected, this setting ensures the argument data type is respected when the operator executes. |

## Adding an Append Operator

In this example, you'll configure a Data Workflow and an Append operator to combine two values. First, you'll configure [Text Field](/v1/docs/text-field-component) components to serve as your inputs. Then, you'll use a Data Workflow to append the values.

### Configure the Text Field Components

Configure two [Text Field](/v1/docs/text-field-component) components to serve as your input fields. Then, configure a third to serve as the output for your Data Workflow.

1. Drag and drop three **T****ext Field** components onto your canvas.
2. Enter the following **Property IDs** and **Label Text**:

| Property ID | Label Text |
| --- | --- |
| firstString | First String |
| secondString | Second String |
| appendedValue | Appended Value |
3. In the **appendedValue** **T****ext Field** component, set the **Disable User Input** toggle to ![A toggle switch indicating an on/off state for a user interface element.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Group 1.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D) **(ON)**

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_Append_TextField_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)
4. **Save & Close** each component as you add it.

### Configure the Data Workflow Component

Next, configure a [Data Workflow](/v1/docs/data-workflow-component) component with two Input operators that are used to bring data from the **input** **Text Field** components into the Data Workflow. Then, you'll configure an Append operator to combine the values and pass the result to an Output operator.

1. Drag and drop a **D****ata Workflow** component onto your canvas, placing it above your **appendedValue** **T****ext Field** component.
2. In the **Canvas Label Text** and **Property Name** fields, enter `dwfAppendStrings`.
3. From the **Trigger Type** drop-down, select **Watch**.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/DWF_Append_Values_Dwf_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)

#### Configure the First Input Operator

1. Drag and drop an **I****nput** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Input |
| Component | firstString |
| Required | Yes |
| Source | Default |

#### Configure the Second Input Operator

1. Drag and drop another **I****nput** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Input |
| Component | secondString |
| Required | Yes |
| Source | Default |

#### Configure the Append Operator

1. Drag and drop an **A****ppend** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Append |
| Label | Append Strings |
3. Connect the output port (right) of the **firstString** **I****nput** operator to the upper input port (left) of the **Append Strings** **A****ppend** operator.
4. Connect the output port (right) of the **secondString** **I****nput** operator to the lower input port (left) of the **Append Strings****A****ppend** operator.

#### Configure the Output Operator

1. Drag and drop an **O****utput** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Output |
| Component | appendedValue |
| Action | value |
3. Connect the output port (right) of the **Append Strings** **A****ppend** operator to the input port (left) of the **appendedValue****O****utput** operator.
4. Click **Save**.
5. **Save** your module.

Here's how the completed example looks in the Module Builder:

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/FINALCONFIGAPPEND_thumb_0_0(1).png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)

**Preview** your module in Express View and enter values into your Text Field components. As you enter your values, you can view them combined in your Appended Value field.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/appendoperatorfinal_thumb_0_0(1).png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A38Z&se=2026-11-07T18%3A57%3A38Z&sr=c&sp=r&sig=7bnr43YUbeKfrWolgRXmU46QW00sdD9Cl0p8S2bkqUU%3D)

## Resources

- [Append Operator Use Case: Appending Tables](/v1/docs/append-operator-appending-tables)

A string is an object that represents a sequence of characters. Strings typically hold data represented in text form.

An array is a type of object that stores one or more data types. Data types supported in arrays include numbers, strings, and objects.

An object is a type of data structure that represents a single, self-contained entity that acts as a container for the characteristics of that entity.

Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View.