What is an Avro File?

The Short Answer

An Avro file is a file with a .avro extension that stores data in Apache Avro's compact binary format. The clever part: the file carries its own schema inside it, so anything reading the file already knows exactly what every field means.

If you've worked with a JSON file before, you already have the right mental model — a file that holds structured data. The difference is that a JSON file is text you can read with your eyes, while an Avro file is binary built for machines to process fast and store cheaply. You'll bump into .avro files most often in data pipelines built on Kafka, Hadoop, and Spark.

What's Actually Inside an Avro File

Every .avro file follows the same layout. Once you've seen it, the format stops feeling mysterious:

That header is the key idea. Because the schema lives inside the file, you can open an Avro file someone created years ago and still know exactly what every value represents — no separate documentation required.

A Real Example

Say you're storing user records. The schema tucked into the file's header looks like this (it's ordinary JSON):

{
  "type": "record",
  "name": "User",
  "namespace": "com.example",
  "fields": [
    { "name": "id",    "type": "int" },
    { "name": "name",  "type": "string" },
    { "name": "email", "type": "string" },
    { "name": "active", "type": "boolean" }
  ]
}

The data blocks then store just the values in binary. If you decoded them back to something readable, three records would look like this:

1, "Alice",   "[email protected]",   true
2, "Bob",     "[email protected]",     false
3, "Charlie", "[email protected]", true

Notice the field names id, name, email appear once in the schema — not on every row like they would in a JSON file. Multiply that saving across millions of records and you can see why .avro files are so much smaller.

How to Open and Read an Avro File

Since .avro files are binary, double-clicking one or opening it in Notepad just shows garbled characters. Here are the real ways to read one:

Here's the Python version, which is about as short as it gets:

from fastavro import reader

with open("users.avro", "rb") as f:
    for record in reader(f):
        print(record)

Avro File vs JSON File

The two often get compared because they store similar data. Here's how they stack up:

Neither is "better" — they're built for different jobs. Reach for a JSON file when you want to read and edit data by hand, and an Avro file when you're moving large volumes efficiently. Want the deeper comparison? See what Apache Avro is.

How to Create an Avro File

You create an Avro file in two steps: define a schema, then write records against it. The fastest way to see the whole thing in action is to start from JSON you already have.

Free Avro Tools

Everything you need to work with .avro files, right in your browser:

Learn More