> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/core-capabilities/automations/workflow-nodes/transformer-nodes.md).

# Transformer Nodes

## Transformer nodes

**Purpose:** Allows you to transform data from one format to another using various transformer functions. They are highly versatile and can be used for a variety of tasks, such as data manipulation, formatting, and conversion. Learn how to configurate transformer nodes below.

### Transformer functions <a href="#configuration-guide" id="configuration-guide"></a>

The transformer node features various transformer functions that you can specify.

#### **Join transformer** <a href="#join" id="join"></a>

* The **Join** transformer allow you to join together a list of items into a single text. It can be joined together with a new line, tab or any form of custom characters.
* The value to join has to be a list of items.
* The join transformer **always** outputs a string.

#### **Map transformer** <a href="#map" id="map"></a>

* The Map transformer allows you to modify each item in a list with something new. For each item you can choose to pick something from the current context (current item), or something completely new.
* The map transformer **always** outputs a list with the new modified values.

### Using multiple transformers <a href="#using-multiple-transformers" id="using-multiple-transformers"></a>

In cases where you would want to use multiple transformers to accomplish a task, you can approach this in two ways.

In the example we will consider the use case of transforming the sources and joining them together.

| Approach   | Description                                                                                                                | Pros                                                                                                            | Cons                                                                                                             |
| ---------- | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Approach 1 | Create a transformer node with the transformer map and feed that output into a transformer node with the join transformer. | <p></p><ul><li>Clear separation of transformers.</li><li>Easier to debug each transformer separately.</li></ul> | <p></p><ul><li>More nodes to manage.</li><li>Slightly more complex setup.</li></ul>                              |
| Approach 2 | Create a transformer node with the transformer join and in the input select map and specify the map.                       | <p></p><ul><li>Fewer nodes to manage.</li><li>More streamlined setup.</li></ul>                                 | <p></p><ul><li>Less clear separation of transformers.</li><li>Harder to debug if something goes wrong.</li></ul> |