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

# Unroll Processor

> Convert a JSON object array within a field into individual objects, commonly used when a source packages multiple events in a single JSON object.

## Description

The Unroll processor converts a JSON object array into individual objects.

## Use

This processor is most commonly used for cases when a source sends a set of objects packaged in a single JSON object. This could include logs or metrics.

## Configuration

There is one option to configure for this processor.

| Option | Description                                           | Example |
| ------ | ----------------------------------------------------- | ------- |
| Field  | The field containing the JSON object array to unroll. | .foo    |

## Example

#### Before

```json theme={null}
{
  'foo': ['bat', 'baz', 'qux'], 
  'bar': 1
}

```

#### Unroll Options

| Option | Value |
| ------ | ----- |
| Field  | .foo  |

#### After

```json theme={null}
{"bar": 1, "foo": "bat"}
{"bar": 1, "foo": "baz"}
{"bar": 1, "foo": "qux"}

```