🚨 Slack Error: 'view_too_large' — Cause, Fix, and Troubleshooting Guide

Overview

view_too_large means the view payload you sent to views.open, views.update, or views.publish exceeds Slack’s size limits. A view is capped at 100 blocks, and the serialised payload has an overall size ceiling; go past either and Slack rejects it.

{
    "ok": false,
    "error": "view_too_large"
}

Symptoms

• Small modals open fine; a data-heavy one fails.
• Failure scales with the amount of dynamic content you inject (long lists, generated rows).
• App Home publishes fail when you render a big dashboard.

Common Root Causes

1. More than 100 blocks

Building a block per record (one per alert, per host, per PR) quickly blows past the 100-block ceiling.

2. Oversized overall payload

Even under 100 blocks, very long text fields or many options in select menus push the serialised size over the limit.

3. Unbounded dynamic content

Rendering an entire query result into a single view with no pagination.

How to diagnose

Count the blocks you’re about to send:

cat view.json | python3 -c 'import json,sys; v=json.load(sys.stdin); print("blocks:", len(v["view"]["blocks"]))'

blocks: 142

Anything over 100 will fail with view_too_large.

Fixes

• Cap at 100 blocks. Truncate lists and show a “showing 25 of 142 — refine your filter” note.
• Paginate with Next/Prev buttons that views.update the same view to the next page of results.
• Use a multi-step modal stack (views.push) to spread content across screens instead of one giant view.
• Compress content: combine fields into fewer section blocks, use fields arrays, and drop decorative dividers.

What to watch out for

• Section blocks allow up to 10 fields; use them to pack more data into fewer blocks.
• Select menus and multi-selects have their own option limits — huge option lists also inflate the payload.
• Design for the worst case: if a view is data-driven, always bound the number of rendered items rather than trusting the data to stay small.

Related

• Slack Error: ‘invalid_blocks’
• Slack Error: ‘too_many_attachments’
• Slack multi-step modal view-stack wizards