# json_array

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [cloud-data-platform-full.txt](https://docs.redpanda.com/cloud-data-platform-full.txt)

---
title: json_array
latest-operator-version: v26.1.4
latest-console-tag: v3.7.3
latest-connect-version: 4.93.0
latest-redpanda-tag: v26.1.9
docname: connect/components/scanners/json_array
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: connect/components/scanners/json_array.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/develop/pages/connect/components/scanners/json_array.adoc
description: Consumes a stream of one or more JSON elements within a top level array.
page-git-created-date: "2025-09-26"
page-git-modified-date: "2026-05-26"
---

<!-- Source: https://docs.redpanda.com/cloud-data-platform/develop/connect/components/scanners/json_array.md -->

**Available in:** Cloud, [Self-Managed](https://docs.redpanda.com/connect/components/scanners/json_array/%20%22View%20the%20Self-Managed%20version%20of%20this%20component%22)

Consumes a stream of one or more JSON elements within a top level array. This scanner is useful for:

-   Processing exports from systems that generate a JSON array as the top-level JSON structure (for example, logs, bulk exports, etc).

-   Efficiently breaking up large files with many objects into individual events/messages.


Suppose you have a file `events.json`:

`events.json`

```json
[
  {"event": "login", "user": "alice"},
  {"event": "logout", "user": "bob"},
  {"event": "purchase", "user": "carol", "amount": 42}
]
```

The configuration to process this file is:

```yaml
input:
  file:
    paths: [ "./events.json" ]
    scanner:
      json_array: {}
```

Result: Each event in the array is processed as a separate message.

## [](#requirements)Requirements

The `json_array` scanner expects the input to be a single JSON array, where each array element is a JSON object or value.

## [](#fields)Fields

The `json_array` scanner has no required fields. You declare it as `{}` in your config.

```yaml
json_array: {}
```