> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-cloud/studio/tasks/reference/concat-array/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# concatArray

> Use the concatArray task to combine the elements of two arrays into a new array.

The `concatArray` task combines the elements of one array with another. The returned array contains copies of all elements from both original arrays. This task does not change the original arrays — it returns a new combined array.

## Potential use case

If you have two datasets and want to combine them into one, use `concatArray`. The task copies object references into the new array.

## Properties

| Incoming | Type  | Required | Description                          |
| :------- | :---- | :------: | :----------------------------------- |
| `arr`    | Array |    Yes   | The first array to concatenate.      |
| `arrayN` | Array |    Yes   | The array to concatenate with `arr`. |

| Outgoing        | Type  | Description                                                      |
| :-------------- | :---- | :--------------------------------------------------------------- |
| `combinedArray` | Array | A new array containing the joined elements of both input arrays. |

## Example

In this example, `arr` is `["a", "b", "c"]` and `arrayN` is `["d", "e", "f"]`.

![](/_fern-img/283170935524c38771beb3adae4ee6e0ab33cdd3a6c66d2152d7ad1eb52897d8.webp)![](/_fern-img/b9f3b95a87b1f6b177ef8de0a4847b4121a4e8120eac52881150533502f977eb.webp)

Once the task runs, the resulting `combinedArray` is `["a", "b", "c", "d", "e", "f"]`.

![](/_fern-img/b0bbe9f9f2cc0ebcf3bc1c53b416bb489bd4dfd6c12f426cfa8d12548ff2e7f3.webp)

## Related reading

See the [concat (array) API](https://apidocs.itential.com/api/app-workflow_engine/arrayConcat/) reference.

> Use the concatArray task to combine the elements of two arrays into a new array.