> ## 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 components and character limits

> Every WhatsApp Flow component with Meta's limits: components per screen, text and label lengths, options per list, images, opt-ins and file uploads.

Every screen in a WhatsApp Flow is built from components: text, inputs, lists, pickers, opt-ins, images and one footer button. Meta limits how many components a screen holds and how long each label and option can be. When a Flow breaks a limit, Meta refuses to publish it. When text is long but within limits, WhatsApp may cut it short on smaller phones.

> [!NOTE]
>
> **In Flowella.** Partly supported. Flowella builds Flows from a set of these components and checks the main limits before it publishes. HubSpot form fields map to the nearest component. See [How HubSpot fields convert](https://knowledge.flowella.io/app/flows.md#how-hubspot-fields-convert) and the [Flow designer](https://knowledge.flowella.io/app/flow-designer.md). Flowella doesn't use navigation lists, chips selectors, calendar pickers or image carousels.

## Limits per screen

| Limit | Maximum |
| - | - |
| Components | 50 |
| Footer (the button at the bottom) | 1 |
| Opt-ins | 5 |
| Embedded links | 2 |
| Images | 3 |
| Photo pickers or document pickers | 1 |

> [!NOTE]
>
> **In Flowella.** Consent checkboxes from a HubSpot form become opt-ins, so they count towards the 5. If a HubSpot form would need more than 50 components, Flowella drops its rich text blocks and keeps every question.

## Text

| Component | Limit |
| - | - |
| Heading | 80 characters |
| Subheading | 80 characters |
| Body | 4,096 characters |
| Caption | 409 characters |
| Rich text | For long content such as terms. From Flow JSON 6.3 it can share a screen with the footer. |

Text can't be empty or only spaces. Body and caption text support bold, italic, strikethrough, links and simple lists.

## Inputs

| Component | Limits |
| - | - |
| **Text input** (single line) | Label 20 characters, helper text 80, error text 30. Answers up to 80 characters by default. Types: text, number, email, password, passcode, phone. |
| **Text area** (multi-line) | Label 20 characters, helper text 80. Answers up to 600 characters by default. |
| **Date picker** | Label 40 characters, helper and error text 80. From Flow JSON 5.0, dates are exchanged as `YYYY-MM-DD`, independent of time zones. |
| **Calendar picker** | Single date or range. Title 80 characters, description 300, label 40. |

## Choices

| Component | Options | Text limits |
| - | - | - |
| **Radio buttons** (pick one) | 1 to 20 | Label and option title 30 characters, description 300 |
| **Checkboxes** (pick several) | 1 to 20 | Label and option title 30 characters, description 300 |
| **Dropdown** | 1 to 200, or 100 if options have images | Label 20 characters, option title 30, description 300 |
| **Opt-in** | One checkbox | 120 characters, with an optional **Read more** link |

Option images must be 100 KB or smaller from Flow JSON 6.0. WebP images don't show on iOS versions before 14.

## Buttons and links

| Component | Limits |
| - | - |
| **Footer** | Label 35 characters, captions 15 characters. One per screen. |
| **Embedded link** | 25 characters, 2 per screen |

## Images and files

| Component | Limits |
| - | - |
| **Image** | JPEG or PNG, ideally under 300 KB, 3 per screen |
| **Photo picker** and **document picker** | Let the customer attach images or documents. Up to 10 files in one response, 100 MB in total. |

> [!WARNING]
>
> Flowella saves photos that customers upload to HubSpot as public files. Don't ask for ID documents or other sensitive images. See [Limits and gotchas](https://knowledge.flowella.io/app/flows.md#limits-and-gotchas).

## Logic

**If** and **Switch** components show or hide parts of a screen based on earlier answers, without calling an endpoint. You can nest up to three **If** components. A footer inside an **If** must appear in both branches. In Flowella, set conditions on the designer's [Logic tab](https://knowledge.flowella.io/app/flow-designer.md#logic-tab).

## Keeping Flows readable

Limits are maximums, not targets. WhatsApp shortens long labels and option titles to fit the screen, so a label that fits on a large phone can be cut off on a small one. For practical rules, see [Form design best practices](https://knowledge.flowella.io/app/form-design-best-practices.md).

## Related

> [card] [Form design best practices](https://knowledge.flowella.io/app/form-design-best-practices.md)
>
> Labels and questions that fit.

> [card] [Flows error codes](https://knowledge.flowella.io/whatsapp/errors/flows-error-codes.md)
>
> What happens when a limit is broken.

> [card] [Flow JSON versions](https://knowledge.flowella.io/whatsapp/flows/flow-json-versions.md)
>
> Which version introduced what.

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

Checked against Meta's documentation on 18 November 2026: [Components](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/components), [Media upload components](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/media_upload) and [Best practices](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/bestpractices).


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