What is a FlowFile in Apache NiFi?

A FlowFile is the fundamental unit of data in Apache NiFi. Every piece of data moving through a flow is represented as a FlowFile with two distinct parts.

Attributes: A map of key-value string pairs acting as metadata. Every FlowFile has core attributes automatically assigned — uuid (globally unique identifier), filename, path, and entryDate. Processors can add, modify, or remove attributes. Attributes are lightweight and kept in memory.

Content: The actual payload bytes. Content is stored in the NiFi content repository on disk, not in heap memory, allowing NiFi to handle FlowFiles of arbitrary size — gigabytes or more — without memory exhaustion. Content is immutable by design: when a processor modifies content, it writes a new version rather than overwriting the original. This immutability underpins the data provenance model.

The separation of attributes from content is architecturally significant. Many routing, filtering, and enrichment operations work purely on attributes without ever reading the payload. RouteOnAttribute, for example, routes FlowFiles entirely on attribute values without touching content.

Invest now in Acorns!!! 🚀
Join Acorns and get your $5 bonus!

Acorns is a micro-investing app that automatically invests your "spare change" from daily purchases into diversified, expert-built portfolios of ETFs. It is designed for beginners, allowing you to start investing with as little as $5. The service automates saving and investing. Disclosure: I may receive a referral bonus.

Invest now!!! Get Free equity stock (US, UK only)!

Use Robinhood app to invest in stocks. It is safe and secure. Use the Referral link to claim your free stock when you sign up!.

The Robinhood app makes it easy to trade stocks, crypto and more.

Webull! Receive free stock by signing up using the link: Webull signup.