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

# WhatsApp Flow JSON versions: freezing and expiry

> How WhatsApp versions Flow JSON, the Data API and Flow messages, what frozen and expired mean for live Flows, and which versions Flowella uses today.

Every WhatsApp Flow declares the version of Flow JSON it's written in, and endpoint Flows also declare a Data API version. Meta adds features in new versions and retires old ones in two steps: a **frozen** version can't be published any more, and an **expired** version can't be sent or opened. Keeping Flows on a supported version is what keeps them working.

> [!NOTE]
>
> **In Flowella.** Supported. Flowella writes every Flow in Flow JSON **7.3**, the latest version, and HubSpot-form Flows use Data API **3.0**. Flowella doesn't move published Flows to a new version by itself: a Flow uses the version Flowella writes at the time you next sync or publish it.

## The three versions

| Version | Format | Controls |
| - | - | - |
| **Flow JSON** | `major.minor`, for example `7.3` | Which components and properties the Flow can use, and how they behave |
| **Data API** | `major.minor`, for example `3.0` | How an endpoint Flow encrypts and formats its requests. Endpoint Flows only. |
| **Message** | A whole number, currently `3` | The format of an interactive Flow message |

A change in the first number is a breaking change, so a Flow may need edits to move to it. A change in the second number adds features without breaking anything. After `1.9` comes `1.10`, not `2.0`.

## Frozen and expired

| State | Publishing | Sending and opening |
| - | - | - |
| **Supported** | Allowed | Allowed |
| **Frozen** | Refused. You can't create or update a Flow on this version. | Still allowed |
| **Expired** | Refused | Refused. Customers can't open Flows on this version, even ones they already received. |

Meta usually gives about 90 days' notice before a version freezes or expires, and announces dates in the Flows changelog. It can act faster for security reasons, and can skip the frozen step entirely.

## Where versions stand

| Version | Released | Status in Meta's changelog |
| - | - | - |
| 7.3 | September 2025 | Latest, not frozen |
| 7.2, 7.1, 7.0 | March to July 2025 | Not frozen |
| 6.0 to 6.3 | November 2024 to January 2025 | Not frozen |
| 5.1 | September 2024 | Not frozen |
| 5.0 | August 2024 | Frozen since 10 September 2025 |
| 4.0, 3.1, 3.0, 2.1 | 2023 to 2024 | Frozen since 8 April 2025 |

Meta's Flows changelog was last updated on 11 November 2025. Check it before you plan a migration.

Data API **4.0**, released in November 2025, adds an optional signature that proves each endpoint request came from someone who received the Flow message. Data API 3.0 remains supported.

## Breaking changes to know about

| Moving to | What changed |
| - | - |
| 4.0 | Checkbox and radio groups need a label. Input names can't be empty. |
| 5.0 | Date pickers exchange dates as `YYYY-MM-DD`, independent of time zones |
| 6.0 | Text values can't be empty or only spaces. Option images must be 100 KB or less. |
| 7.0 | Selecting an option no longer re-runs its action when a screen opens again |

## What to do when Meta announces a freeze

* **Flows built in Flowella** use the version Flowella writes. When Flowella moves to a newer version, sync or publish each Flow again to move it across.
* **Flows built in WhatsApp Manager or another tool** need updating there before the version expires. Meta shows warnings in its Flow builder and sends version warning webhooks.
* **Before a version expires**, replace any template whose Flow is still on it, or customers who tap the button can't open the Flow.

## Related

> [card] [WhatsApp Flows overview](https://knowledge.flowella.io/whatsapp/flows/flows-overview.md)
>
> How Flows and their states work.

> [card] [Flow components and limits](https://knowledge.flowella.io/whatsapp/flows/flow-components-and-limits.md)
>
> What each version can show.

> [card] [Flow endpoints and security](https://knowledge.flowella.io/whatsapp/flows/flow-endpoints-and-security.md)
>
> Data API versions in practice.

> [card] [Platform changes](https://knowledge.flowella.io/whatsapp/platform-changes.md)
>
> Upcoming Meta changes that affect Flowella.

Checked against Meta's documentation on 18 November 2026: [Versioning](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/versioning) and the [WhatsApp Flows changelog](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/changelog).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.