Fixing Component Limit Errors in WhatsApp Flow Builder (2025) - How to avoid “MAX_FOOTER_PER_SCREEN” and similar validation errors

TL;DR 

If you’re seeing an error like:
Maximum number of Footer allowed per screen is 1 but found 2
It means you’ve exceeded the allowed number of a specific component type in a single screen of your Flow.

Solution

Remove the extra component(s) from that screen. Each screen must stay within these limits:

​

What’s Going On?

WhatsApp Flows enforce strict per-screen component limits to keep the UI clean and functional. If you try to add more than the allowed number, your Flow will throw a schema error—like this:

{
  "error": "MAX_FOOTER_PER_SCREEN",
  "message": "Maximum number of Footer allowed per screen is 1 but found 2"
}

These limits are not configurable and must be respected for the Flow to validate.

Common Scenario: Duplicate Components

Here's a problematic screen with two footers, which will trigger a MAX_FOOTER_PER_SCREEN error:

"layout": {
  "children": [
    {
      "type": "Footer",
      "label": "Submit"
    },
    {
      "type": "Footer",
      "label": "Cancel"
    }
  ]
}

Fix: Remove one of them or merge actions if possible. Keep only one Footer component:

"layout": {
  "children": [
    {
      "type": "Footer",
      "label": "Submit"
    }
  ]
}

For more troubleshooting insights related to WhatsApp Business API, check out heltar.com/blogs.