> ## Documentation Index
> Fetch the complete documentation index at: https://docs.odella.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Array Block

> Construct an array from one or more inputs of any type, with options for flattening and merging arrays

## Overview

The Array Block is used to construct an array from one or more inputs of any type. It can also be used to merge multiple arrays into a single array using the `Flatten` setting.

By default, inputs will be flattened, so if any of the inputs are arrays themselves, they will be merged into the output array. This behavior can be disabled by unchecking the `Flatten` setting.

<Frame>
  <img src="https://mintcdn.com/odella/MNHyQg3-ZFMTYSp3/block-reference/assets/array_light.png?fit=max&auto=format&n=MNHyQg3-ZFMTYSp3&q=85&s=327a4991ee0dbb1b50ae103abd3b65b3" alt="Array Block Screenshot" className="block dark:hidden" width="762" height="428" data-path="block-reference/assets/array_light.png" />

  <img src="https://mintcdn.com/odella/MNHyQg3-ZFMTYSp3/block-reference/assets/array_dark.png?fit=max&auto=format&n=MNHyQg3-ZFMTYSp3&q=85&s=b74f73415cebbea44825361c6bf40dc1" alt="Array Block Screenshot" className="hidden dark:block" width="786" height="448" data-path="block-reference/assets/array_dark.png" />
</Frame>

## Inputs

<ParamField path="Input [i]" type="any">
  An input to create the array from. If an array, will be flattened if the "Flatten" option is enabled. The number of inputs is dynamic based on how many connections there are.
</ParamField>

## Outputs

<ResponseField name="Output" type="any[]">
  The array created from the inputs.
</ResponseField>

<ResponseField name="Indices" type="number[]">
  The indices of the array. I.e. \[0, 1, 2, 3, etc]. Useful for zipping with the output array to get the indexes.
</ResponseField>

<ResponseField name="Length" type="number">
  The length of the output array.
</ResponseField>

## Editor Settings

<ParamField path="Flatten" type="boolean" default={true}>
  If enabled, array inputs will be flattened before joining.
</ParamField>

<ParamField path="Deep" type="boolean" default={false}>
  If enabled, array inputs will be flattened recursively.
</ParamField>

## Example: Creating an Array from Multiple Inputs

1. Add an Array Block to your flow.
2. Connect three Text blocks with values `"Hello"`, `"World"`, and `"!"` to `Input 1`, `Input 2`, and `Input 3` of the Array Block respectively.

The `Output` of the Array Block will be `["Hello", "World", "!"]`.

## Example: Creating an Array from Array Inputs

1. Add an Array Block to your flow.
2. Connect two Array blocks with values `["One", "Two"]` and `["Three", "Four"]` to `Input 1` and `Input 2` of the Array Block.
3. Enable the `Flatten` setting.

The `Output` of the Array Block will be `["One", "Two", "Three", "Four"]`.

## Example: Using the Indices Output

1. Add an Array Block with value `["Apple", "Banana", "Cherry"]`.
2. Add a Text Block with text `"[{{index}}] - {{fruit}}"`.
3. Connect the `Output` of the Array Block to the `Fruit` input of the Text Block.
4. Connect the `Indices` output of the Array Block to the `Index` input of the Text Block.
5. Enable the `Split` setting on the Text Block.

The `Output` of the Text Block will be `["[0] - Apple", "[1] - Banana", "[2] - Cherry"]`.

## Flattening Arrays

The `Flatten` setting treats each element of an array input as a separate element to be added to the main array. The `Deep` setting recursively flattens all array inputs.

<Warning>
  With flatten disabled, you can get arrays of arrays. These are not well supported in Odella and you may have to use a [Code Block](/block-reference/advanced/code) to work with them.
</Warning>

## Error Handling

If an input is missing or null, the Array Block will simply ignore it during the array creation process.

## FAQ

<AccordionGroup>
  <Accordion title="What happens if I connect a non-array block to the Array Block?">
    The Array Block will treat it as a single element to be added to the array.
  </Accordion>

  <Accordion title="Can I connect an Array Block to another Array Block?">
    Yes. If `Flatten` is enabled, each element of the input array will be treated as a separate element. If disabled, the input array will be added as a single element.
  </Accordion>

  <Accordion title="What happens if an input is missing or null?">
    The Array Block will simply ignore it during the array creation process.
  </Accordion>
</AccordionGroup>

## See Also

* [Code Block](/block-reference/advanced/code)
* [Text Block](/block-reference/data/text)
* [Number Block](/block-reference/data/number)
* [Extract Object Path Block](/block-reference/modifiers/extract-object-path)
* [Pop Block](/block-reference/modifiers/pop)