# Configure Data Transforms

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [cloud-data-platform-full.txt](https://docs.redpanda.com/cloud-data-platform-full.txt)

---
title: Configure Data Transforms
latest-operator-version: v26.1.4
latest-console-tag: v3.7.3
latest-connect-version: 4.93.0
latest-redpanda-tag: v26.1.9
docname: data-transforms/configure
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: data-transforms/configure.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/develop/pages/data-transforms/configure.adoc
description: Learn how to configure data transforms in Redpanda, including editing the <code>transform.yaml</code> file, environment variables, and memory settings. This topic covers both the configuration of transform functions and the WebAssembly (Wasm) engine's environment.
page-git-created-date: "2025-04-08"
page-git-modified-date: "2026-05-26"
---

<!-- Source: https://docs.redpanda.com/cloud-data-platform/develop/data-transforms/configure.md -->

Learn how to configure data transforms in Redpanda, including editing the `transform.yaml` file, environment variables, and memory settings. This topic covers both the configuration of transform functions and the WebAssembly (Wasm) engine’s environment.

## [](#configure-transform-functions)Configure transform functions

This section covers how to configure transform functions using the `transform.yaml` configuration file, command-line overrides, and environment variables.

### [](#config-file)Transform configuration file

When you [initialize](https://docs.redpanda.com/cloud-data-platform/develop/data-transforms/build/#init) a data transforms project, a `transform.yaml` file is generated in the provided directory. You can use this configuration file to configure the transform function with settings, including input and output topics, the language used for the data transform, and any environment variables.

-   `name`: The name of the transform function.

-   `description`: A description of what the transform function does.

-   `input-topic`: The topic from which data is read.

-   `output-topics`: A list of up to eight topics to which the transformed data is written.

-   `language`: The language used for the transform function. The language is set to the one you defined during [initialization](https://docs.redpanda.com/cloud-data-platform/develop/data-transforms/build/#init).

-   `env`: A dictionary of custom environment variables that are passed to the transform function. Do not prefix keys with `REDPANDA_`. Check the list of all [limitations](https://docs.redpanda.com/cloud-data-platform/develop/data-transforms/how-transforms-work/#limitations).


Here is an example of a transform.yaml file:

```yaml
name: redpanda-example
description: |
  This transform function is an example to demonstrate how to configure data transforms in Redpanda.
input-topic: example-input-topic
output-topics:
  - example-output-topic-1
  - example-output-topic-2
language: tinygo-no-goroutines
env:
  DATA_TRANSFORMS_ARE_AWESOME: 'true'
```

### [](#cl)Override configurations with command-line options

You can set the name of the transform function, environment variables, and input and output topics on the command-line when you deploy the transform. These command-line settings take precedence over those specified in the `transform.yaml` file.

See [Deploy Data Transforms](https://docs.redpanda.com/cloud-data-platform/develop/data-transforms/deploy/)

### [](#built-in)Built-In environment variables

As well as custom environment variables set in either the [command-line](#cl) or the [configuration file](#config-file), Redpanda makes some built-in environment variables available to your transform functions. These variables include:

-   `REDPANDA_INPUT_TOPIC`: The input topic specified.

-   `REDPANDA_OUTPUT_TOPIC_0..REDPANDA_OUTPUT_TOPIC_N`: The output topics in the order specified on the command line or in the configuration file. For example, `REDPANDA_OUTPUT_TOPIC_0` is the first variable, `REDPANDA_OUTPUT_TOPIC_1` is the second variable, and so on.


Transform functions are isolated from the broker’s internal environment variables to maintain security and encapsulation. Each transform function only uses the environment variables explicitly provided to it.

## [](#configure-the-wasm-engine)Configure the Wasm engine

This section covers how to configure the Wasm engine environment using Redpanda cluster configuration properties.

### [](#enable-transforms)Enable data transforms

To use data transforms, you must enable it for a Redpanda cluster using the [`data_transforms_enabled`](https://docs.redpanda.com/cloud-data-platform/reference/properties/cluster-properties/#data_transforms_enabled) property.

### [](#log)Configure transform logging

The following properties configure logging for data transforms:

-   [`data_transforms_logging_line_max_bytes`](https://docs.redpanda.com/cloud-data-platform/reference/properties/cluster-properties/#data_transforms_logging_line_max_bytes): Increase this value if your log messages are frequently truncated. Setting this value too low may truncate important log information.


## [](#next-steps)Next steps

[Deploy Data Transforms](https://docs.redpanda.com/cloud-data-platform/develop/data-transforms/deploy/)