﻿---
title: Rename processor
description: Use the Rename processor to change the name of a field, moving its value to a new field name and removing the original. To use a rename processor: Select...
url: https://www.elastic.co/elastic/docs-builder/docs/2988/solutions/observability/streams/management/extract/rename
products:
  - Elastic Cloud Enterprise
  - Elastic Cloud Hosted
  - Elastic Cloud Serverless
  - Elastic Cloud on Kubernetes
  - Elastic Observability
  - Elastic Stack
  - Elasticsearch
  - Kibana
applies_to:
  - Elastic Cloud Serverless: Generally available
  - Elastic Stack: Generally available since 9.2, Preview in 9.1
---

# Rename processor
Use the **Rename** processor to change the name of a field, moving its value to a new field name and removing the original.
To use a rename processor:
1. Select **Create** → **Create processor**.
2. Select **Rename** from the **Processor** menu.
3. Set **Source Field** to the field you want to rename.
4. Set **Target field** to the new name you want to use for the **Source Field**.

This functionality uses the Elasticsearch [Rename processor](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2988/reference/enrich-processor/rename-processor) internally, but you configure it in Streamlang. Streamlang doesn't always have 1:1 parity with the ingest processor options and behavior. Refer to [Processor limitations and inconsistencies](/elastic/docs-builder/docs/2988/solutions/observability/streams/management/extract#streams-processor-inconsistencies).

## YAML reference

In [YAML mode](/elastic/docs-builder/docs/2988/solutions/observability/streams/management/extract#streams-editing-yaml-mode), configure the rename processor using the following parameters. For the complete Streamlang syntax, refer to the [Streamlang reference](https://www.elastic.co/elastic/docs-builder/docs/2988/solutions/observability/streams/management/streamlang).

| Parameter        | Type    | Required | Description                                                      |
|------------------|---------|----------|------------------------------------------------------------------|
| `from`           | string  | Yes      | Source field to rename.                                          |
| `to`             | string  | Yes      | New field name.                                                  |
| `ignore_missing` | boolean | No       | When `true`, skip this processor if the source field is missing. |
| `override`       | boolean | No       | When `true`, allow overwriting an existing target field.         |

```yaml
- action: rename
  from: attributes.old_name
  to: attributes.new_name
```