Skip to main content

Rename Transform

The Rename transform changes one or more column names.

Basic Usage​

To rename columns:

  1. Select the Rename transform from the transform menu.
  2. For each rename pair: a. Choose a field under Target Columns. b. Enter its new name under Rename Column.
  3. Apply the transformation.

Configure and apply the Rename Columns transform

Configuration Options​

Basic Options​

  • Target Columns: Choose a column to rename.
  • Rename Column: Enter its new name.
note

Add another Target Columns and Rename Column pair for each additional field.

caution

The workflow UI does not accept periods (.) in new names. The backend changes periods to spaces only in legacy configurations, API-created nodes, and direct backend calls. Names entered in the UI cannot use this fallback.

Examples​

Example: Standardizing Column Names

Input Dataset:

first_namelast_nameDOBphone_num
JohnDoe1990-01-011234567890
JaneSmith1985-05-159876543210

Configuration:

  • Select Column: first_name, Rename Column: FirstName
  • Select Column: last_name, Rename Column: LastName
  • Select Column: DOB, Rename Column: DateOfBirth
  • Select Column: phone_num, Rename Column: PhoneNumber

Result:

FirstNameLastNameDateOfBirthPhoneNumber
JohnDoe1990-01-011234567890
JaneSmith1985-05-159876543210
tip

Use one naming convention throughout the dataset, such as snake_case or PascalCase.

Best Practices​

  1. Choose short names that describe the field clearly.
  2. Use one naming convention and avoid special characters.
  3. Check downstream nodes, code, and reports for references to the old name.
  4. Document renames when the workflow is shared or audited.

Troubleshooting​

  • The preview still shows the old name: Refresh the data view.
  • The wrong field was renamed: Check Select Column.
  • The rename fails: Make sure the new name is unique. Duplicate names are not accepted.