# 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> |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ebbot.ai/ebbot-docs/core-capabilities/automations/workflow-nodes/transformer-nodes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.