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

# Array Join

> Join values from an array using a specified delimiter

The Array Join command (Command Type: 1014) joins values from an array using a specified delimiter. This command is useful for combining extracted array values into a single string output.

## Overview

The Array Join command provides functionality for:

* Joining array values into a delimited string
* Batching join results by limiting items per batch
* Extracting a specific property from objects before joining

## Command Type

**Command Type ID:** 1014

## Parameters

| Parameter     | Type   | Description                                                                       | Required |
| ------------- | ------ | --------------------------------------------------------------------------------- | -------- |
| **delimiter** | string | The character or sequence used to separate the joined values                      | Yes      |
| **key**       | string | Specifies the property in the objects whose values will be joined                 | Yes      |
| **batchSize** | number | Optional batching of joined results by limiting the number of items in each batch | No       |

## Usage Examples

### Basic Array Join

```json theme={null}
{
  "command": "array-join",
  "params": {
    "delimiter": ",",
    "key": "id"
  }
}
```

### Join with Batch Size

```json theme={null}
{
  "command": "array-join",
  "params": {
    "delimiter": "|",
    "key": "name",
    "batchSize": 50
  }
}
```

### Join with Custom Delimiter

```json theme={null}
{
  "command": "array-join",
  "params": {
    "delimiter": ";",
    "key": "value"
  }
}
```

## Common Use Cases

* **ID Concatenation**: Join extracted IDs into a comma-separated string for API queries
* **Batch Processing**: Split large arrays into batches before joining
* **Data Aggregation**: Combine field values from multiple objects into one string

## Related Commands

* [Json Path](/stream/commands/parse/json-path) - Extract array data before joining
* [Filter](/stream/commands/parse/filter) - Filter array items before joining
* [Distinct](/stream/commands/parse/distinct) - Remove duplicates before joining
