# avro

> 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: avro
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/processors/avro
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: connect/components/processors/avro.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/develop/pages/connect/components/processors/avro.adoc
page-git-created-date: "2024-09-09"
page-git-modified-date: "2026-05-26"
---

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

**Type:** Processor ▼

[Processor](https://docs.redpanda.com/cloud-data-platform/develop/connect/components/processors/avro/)[Scanner](https://docs.redpanda.com/cloud-data-platform/develop/connect/components/scanners/avro/)

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

Performs Avro based operations on messages based on a schema.

```yml
# Config fields, showing default values
label: ""
avro:
  operator: "" # No default (required)
  encoding: textual
  schema: ""
  schema_path: ""
```

> ⚠️ **WARNING**
>
> If you are consuming or generating messages using a schema registry service then it is likely this processor will fail as those services require messages to be prefixed with the identifier of the schema version being used. Instead, try the [`schema_registry_encode`](https://docs.redpanda.com/cloud-data-platform/develop/connect/components/processors/schema_registry_encode/) and [`schema_registry_decode`](https://docs.redpanda.com/cloud-data-platform/develop/connect/components/processors/schema_registry_decode/) processors.

## [](#operators)Operators

### [](#to_json)`to_json`

Converts Avro documents into a JSON structure. This makes it easier to manipulate the contents of the document within Benthos. The encoding field specifies how the source documents are encoded.

### [](#from_json)`from_json`

Attempts to convert JSON documents into Avro documents according to the specified encoding.

## [](#fields)Fields

### [](#encoding)`encoding`

An Avro encoding format to use for conversions to and from a schema.

**Type**: `string`

**Default**: `textual`

**Options**: `textual`, `binary`, `single`

### [](#operator)`operator`

The [operator](#operators) to execute

**Type**: `string`

**Options**: `to_json`, `from_json`

### [](#schema)`schema`

A full Avro schema to use.

**Type**: `string`

**Default**: `""`

### [](#schema_path)`schema_path`

The path of a schema document to apply. Use either this or the `schema` field. URLs must begin with `file://` or `http://`. Note that `file://` URLs must use absolute paths (e.g. `[file:///absolute/path/to/spec.avsc](file:///absolute/path/to/spec.avsc)`); relative paths are not supported.

**Type**: `string`

**Default**: `""`

```yaml
# Examples:
schema_path: file:///path/to/spec.avsc

# ---

schema_path: http://localhost:8081/path/to/spec/versions/1
```