Rename

Rename a column or list of columns.

Parameters

Name	Description	Accepted Values	Default	Required
I/O
input	Name or list of input columns.	string, integer, array, null	null	No
output	Name or list of output columns.	string, array, null	null	No
Conditions
if	Condition that determines whether the wrangle runs as a whole. Recipe variables may be referenced with ${variable}.	string	—	No
Execution
wrangles	Use wrangles to transform the column names. The input is named 'columns' and the final result must also include the column named 'columns'. This can only be used instead of the standard rename.	array, null	null	No

Examples

note

Rename is not compatible with where filtering.

wrangles:
  - rename:
      input:
        - Manufacturer Name
        - Manufacturer Part Number
      output:
        - Manufacturer
        - MPN

Manufacturer Name	Manufacturer Part Number
SKF	302-2
Timken	PF48

Manufacturer	MPN
SKF	302-2
Timken	PF48

wrangles:
  - rename:
      Manufacturer Name: Manufacturer
      Manufacturer Part Number: MPN

Manufacturer Name	Manufacturer Part Number
SKF	302-2
Timken	PF48

Manufacturer	MPN
SKF	302-2
Timken	PF48

wrangles:
  - rename:
      wrangles:
        - convert.case:
            input: columns
            case: upper

Manufacturer Name	Manufacturer Part Number
SKF	302-2
Timken	PF48

MANUFACTURER NAME	MANUFACTURER PART NUMBER
SKF	302-2
Timken	PF48

Access

Requirement	Value
AI-powered	No
Requires WrangleWorks account	No
Requires subscription	No
Requires external API key	No

Technical details

Field	Value
Catalog ID	89
Catalog key	rename
Recipe key	rename
Catalog status	active
Lifecycle status	active
Recipe Writer eligible	No
Recipe Writer exclusion	Structural rename steps are not supported in the baseline.
Namespace	Root-level
Documentation group	transform
Aliases	None
Runtime symbol	wrangles.recipe_wrangles.main.rename
Legacy UUID	ab06898f-faf7-42e7-8275-5e3034a4d727

Sources

• WranglesPY rename implementation
• Archived rename Markdown