---
title: "Rename Field Operator"
slug: "rename-field-operator"
updated: 2025-09-26T06:04:33Z
published: 2025-09-26T06:04:33Z
canonical: "docs.unqork.io/rename-field-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.

# Rename Field Operator

UDesignerClassic Designer

## Overview

The **Rename Field operator** updates key names in your data, making it easier to identify and reference fields throughout your [Data Workflow](/v1/docs/data-workflow-component).

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

When you store data in your [application](/v1/docs/introduction-to-unqork-applications), it’s typically organized into arrays. Each array contains fields and values known as key/value pair. These fields are used to locate and modify data.

Data can come from sources like APIs or Data Collection components, like a [Data Table](/v1/docs/data-table-component) component. Typically, these fields are automatically generated and can be difficult to understand. For example, a field might be named `1234_name`, which is not easy to recognize or reference. The Rename Field operator lets you change those names to be more meaningful, like `employeeName`.

You'll find the Rename Field operator under the [Table operators](/v1/docs/introduction-to-data-workflow-table-operators) group to the left of the [Data Workflow](/v1/docs/data-workflow-component) canvas.

## About the Info Window

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

| Info |
| --- |
| **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. |
| **Current Name** | Enter the current name of the field you want to rename. |
| **Target Name** | Enter the new name you want to use to replace the Current Name value. |

> [!NOTE]
> Current Name and Target Name settings can only have one string, formula, or argument value. You can use the same formulas you'd use in a [Calculator](/v1/docs/calculator-component) component. For more information on formulas, view our [Unqork Formulas](/v1/docs/unqork-formulas) article.

## Adding a Rename Field Operator

In this example, you'll use the Rename Field operator to update a field name in a [Data Table](/v1/docs/data-table-component) component. This example uses an interactive approach, where the end-user can enter the field name they want.

> [!NOTE]
> These instructions assume you have a new module open and saved with a title.

### Configure the Data Table Component

You'll begin by adding a [Data Table](/v1/docs/data-table-component) component and populate it with sample fields you'll rename.

1. In the Module Builder, drag and drop a **Data Table** component onto your canvas.
2. In the Property ID field, enter **dtSampleData**.
3. In the data table, enter the following:

|  | A | B |
| --- | --- | --- |
| 1 | name | title |
| 2 | Olivia Goodwin | Aspiring Novelist |
| 3 | Irene Carline | Brand Warrior |
| 4 | Andy Andrus | Punctuation Prodigy |

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/RenameField_DataTable_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A51Z&se=2026-11-07T18%3A57%3A51Z&sr=c&sp=r&sig=xLQI6NYYa3%2F1kOAhJCCESuzAlGyYQL4%2BD%2Fm8xgA7vEU%3D)
4. Click **Save Component**.

### Configure the Text Field Component

Next, you'll configure a [Text Field](/v1/docs/text-field-component) component where your end-users can change the field name.

1. Drag and drop a **T****ext Field** component onto your canvas, placing it below the **Data Table** component.
2. In the Property ID field, enter **newNameTitleField**.
3. In the Label Text, enter `New Name for Field "Title"`.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/RENAME_FIELD_TEXTFIELD_thumb_0_0(1).jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A51Z&se=2026-11-07T18%3A57%3A51Z&sr=c&sp=r&sig=xLQI6NYYa3%2F1kOAhJCCESuzAlGyYQL4%2BD%2Fm8xgA7vEU%3D)
4. Click **Save Component**.

### Configure the Data Workflow Component

Next, you'll set up the [Data Workflow](/v1/docs/data-workflow-component) component, which uses the Text Field component's entry to rename your data field.

1. Drag and drop a **D****ata Workflow** onto your canvas, placing it below the **newNameTitleField** **T****ext Field** component.
2. In the Property ID and Canvas Label Text fields, enter `dwfRename`.

#### Configure the Input Operators

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** | dtSampleData |
| **Required** | Yes |
| **Source** | Default |
3. Drag and drop a second **I****nput** operator onto your **D****ata Workflow** canvas.
4. Configure the second operator's **Info** window as follows:

| Info |
| --- |
| **Category** | Input |
| **Component** | newNameTitleField |
| **Required** | Yes |
| **Source** | Default |

#### Configure the Rename Field Operator

1. Drag and drop a **R****ename Field** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Info |
| --- |
| **Category** | Rename Field |
| **Label** | New Title |
| **Current Name** | title |
| **Target Name** | _arg |

> [!NOTE]
> Connecting the Text Field component to the argument port (top) of the Rename Field operator uses the Text Field component entry to rename the **Current Name** data field.
3. Connect the output port (right) of the **dtSampleData** **I****nput** operator to the input port (left) of the **New Title****R****ename Field** operator.
4. Connect the output port (right) of the **newNameTitleField** **I****nput** operator to the argument port (top) of the **New Title****R****ename Field** operator.

#### Configure the First Console Operator

Now, add a [Console](/v1/docs/console-operator) operator before the Rename Field operator to view the current field name in the DevTools Console.

1. Drag and drop a **C****onsole** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Info |
| --- |
| **Category** | Console |
| **Label** | Before |
3. Connect the output port (right) of the **dtSampleData** **I****nput** operator to the input port (left) of the **Before** **C****onsole** operator.

#### Configure the Second Console Operator

Then, add a second Console operator to view the new field name after the data passes through the Rename Field operator.

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

| Info |
| --- |
| **Category** | Console |
| **Label** | After |
3. Connect the output port (right) of the **New Title****R****ename Field** operator to the input port (left) of the **After** **C****onsole** operator.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Rename_Field_DataWorkflow_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A51Z&se=2026-11-07T18%3A57%3A51Z&sr=c&sp=r&sig=xLQI6NYYa3%2F1kOAhJCCESuzAlGyYQL4%2BD%2Fm8xgA7vEU%3D)
4. Click **Save Component**.

### Configure the Button Component

Lastly, configure a [Button](/v1/docs/button-component) component to trigger the Data Workflow in Express View.

1. Drag and drop a **Button** component onto your canvas, placing it below the **dwfRename****D****ata Workflow** component.
2. In the Property ID field, enter **btnRename**.
3. In the Label Text field, enter `Rename Field`.
4. From the **Action Type** drop-down, select **Event**.
5. From the **On Click** drop-down, select **dwfRename**.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/RenaemField_Button_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A51Z&se=2026-11-07T18%3A57%3A51Z&sr=c&sp=r&sig=xLQI6NYYa3%2F1kOAhJCCESuzAlGyYQL4%2BD%2Fm8xgA7vEU%3D)
6. Click **Save Component**.
7. **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/RenameField_ModuleBuilder_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A51Z&se=2026-11-07T18%3A57%3A51Z&sr=c&sp=r&sig=xLQI6NYYa3%2F1kOAhJCCESuzAlGyYQL4%2BD%2Fm8xgA7vEU%3D)

**Preview** your module in Express View and open the DevTools Console. Run the , enter a new name for the title field, and Rename Field to view the results.

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

## Overview

The **Rename Field operator** updates key names in your data, making it easier to identify and reference fields throughout your [Data Workflow](/v1/docs/data-workflow-component).

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

When you store data in your [application](/v1/docs/introduction-to-unqork-applications), it’s typically organized into arrays. Each array contains fields and values known as key/value pair. These fields are used to locate and modify data.

Data can come from sources like APIs or Data Collection components, like a [Data Table](/v1/docs/data-table-component) component. Typically, these fields are automatically generated and can be difficult to understand. For example, a field might be named `1234_name`, which is not easy to recognize or reference. The Rename Field operator lets you change those names to be more meaningful, like `employeeName`.

You'll find the Rename Field operator under the [Table operators](/v1/docs/introduction-to-data-workflow-table-operators) group to the left of the [Data Workflow](/v1/docs/data-workflow-component) canvas.

## About the Info Window

Here's a breakdown of each setting in the Rename Field 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. |
| Current Name | Enter the current name of the field you want to rename. |
| Target Name | Enter the new name you want to use to replace the Current Name value. |

> [!NOTE]
> Current Name and Target Name settings can only have one string, formula, or argument value. You can use the same formulas you'd use in a [Calculator](/v1/docs/calculator-component) component. For more information on formulas, view our [Unqork Formulas](/v1/docs/unqork-formulas) article.

## Adding a Rename Field Operator

In this example, you'll use the Rename Field operator to update a field name in a [Data Table](/v1/docs/data-table-component) component. This example uses an interactive approach, where the end-user can enter the field name they want.

> [!NOTE]
> These instructions assume you have a new module open and saved with a title.

### Configure the Data Table Component

You'll begin by adding a [Data Table](/v1/docs/data-table-component) component and populate it with sample fields you'll rename.

1. In the Module Builder, drag and drop a **Data Table** component onto your canvas.
2. In the Property ID and Canvas Label Text fields, enter `dtSampleData`.
3. To the left of the component's configuration window, click **D****ata**.
4. In the data table, enter the following:

| A | B |
| --- | --- |
| name | title |
| Olivia Goodwin | Aspiring Novelist |
| Irene Carline | Brand Warrior |
| Andy Andrus | Punctuation Prodigy |

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/RenameField_Classic_Datatable_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A51Z&se=2026-11-07T18%3A57%3A51Z&sr=c&sp=r&sig=xLQI6NYYa3%2F1kOAhJCCESuzAlGyYQL4%2BD%2Fm8xgA7vEU%3D)
5. Click **Save & Close**.

### Configure the Text Field Component

Next, you'll configure a [Text Field](/v1/docs/text-field-component) component where your end-users can change the field name.

1. Drag and drop a **T****ext Field** component onto your canvas, placing it below the **Data Table** component.
2. In the Property ID field, enter **newNameTitleField**.
3. In the Label Text, enter `New Name for Field "Title"`.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/RenameField_Classic_Textfield_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A51Z&se=2026-11-07T18%3A57%3A51Z&sr=c&sp=r&sig=xLQI6NYYa3%2F1kOAhJCCESuzAlGyYQL4%2BD%2Fm8xgA7vEU%3D)
4. Click **Save & Close**.

### Configure the Data Workflow Component

Next, you'll set up the [Data Workflow](/v1/docs/data-workflow-component) component, which uses the Text Field component's entry to rename your data field.

1. Drag and drop a **D****ata Workflow** onto your canvas, placing it below the **newNameTitleField** **T****ext Field** component.
2. In the Canvas Label Text and Property ID fields, enter `dwfRename`.

#### Configure the Input Operators

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 | dtSampleData |
| Required | Yes |
| Source | Default |
3. Drag and drop the second **I****nput** operator onto your **D****ata Workflow** canvas.
4. Configure the second operator's **Info** window as follows:

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

#### Configure the Rename Field Operator

1. Drag and drop the **R****ename Field** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Rename Field |
| Label | New Title |
| Current Name | title |
| Target Name | _arg |

> [!NOTE]
> Connecting the Text Field component to the argument port (top) of the Rename Field operator uses the Text Field component entry to rename the **Current Name** data field.
3. Connect the output port (right) of the **dtSampleData** **I****nput** operator to the input port (left) of the **New Title****R****ename Field** operator.
4. Connect the output port (right) of the **newNameTitleField** **I****nput** operator to the argument port (top) of the **New Title****R****ename Field** operator.

#### Configure the First Console Operator

Now, add a [Console](/v1/docs/console-operator) operator before the Rename Field operator to view the current field name in the DevTools Console.

1. Drag and drop a **C****onsole** operator onto your **D****ata Workflow** canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | Before |
3. Connect the output port (right) of the **dtSampleData** **I****nput** operator to the input port (left) of the **Before** **C****onsole** operator.

#### Configure the Second Console Operator

Then, add a second Console operator to view the new field name after the data passes through the Rename Field operator.

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

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | After |
3. Connect the output port (right) of the **New Title****R****ename Field** operator to the input port (left) of the **After** **C****onsole** operator.
4. Click **Save**.

Here's how the completed Data Workflow looks:

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

### Configure the Button Component

Lastly, configure a [Button](/v1/docs/button-component) component to trigger the Data Workflow in Express View.

1. Drag and drop a **Button** component onto your canvas, placing it below the **dwfRename****D****ata Workflow** component.
2. In the Property ID field, enter **btnRename**.
3. In the Label Text field, enter `Rename Field`.
4. To the left of the component's configuration window, click **Actions**.
5. Set the **Action Type** as **Event**.
6. From the **On Click** drop-down, select **dwfRename**.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/RenameField_Classic_Button_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A51Z&se=2026-11-07T18%3A57%3A51Z&sr=c&sp=r&sig=xLQI6NYYa3%2F1kOAhJCCESuzAlGyYQL4%2BD%2Fm8xgA7vEU%3D)
7. Click **Save & Close**.
8. **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/RenameField_Classic_Configuration_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A51Z&se=2026-11-07T18%3A57%3A51Z&sr=c&sp=r&sig=xLQI6NYYa3%2F1kOAhJCCESuzAlGyYQL4%2BD%2Fm8xgA7vEU%3D)

**Preview** your module in Express View and open the DevTools Console. Run the , enter a new name for the title field, and Rename Field to view the results.

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

## Resources

- [Modify the Rename Field operator](/v1/docs/modifying-data-workflow-operators).
- [Input/Output Operators](/v1/docs/introduction-to-data-workflow-io-operators).
- [Gateway Operators](/v1/docs/introduction-to-data-workflow-gateways-operators).
- [Table Operators Landing Page.](/v1/docs/tableoperators)
- [Modifying Data Workflow Operators](/v1/docs/modifying-data-workflow-operators).

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

A key-value pair is a fundamental data structure where a unique "key" is associated with a specific "value," used for organizing and retrieving data efficiently, like in dictionaries or databases.

APIs (application programming interfaces) are a set of protocols and definitions developers use to build and integrate application software. APIs act as the connective tissue between products and services.

A Data Collection is any static data referenced by your application.

End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.

A Property ID is the unique field ID used by Unqork to track and link components in your module.

End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.

Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field.

Canvas Label Text indicates the purpose of the corresponding field or component. For non-input components, the Canvas Label Text isn't end-user facing, and only appears in the .

The DevTools Console helps you securely store, build, test, and deploy your software.

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.