Asset 20 8 2
Does AI recommend your business? Run the free check →

Join 15,000 business owners, marketers and entrepreneurs. The Sunday newsletter you'll be annoyed only arrives once a week.

Article

Notion Page Size Limit: What's Capped and What Isn't

Notion doesn't publish one maximum page size. The documented limits are a 1,000 block and 500KB cap per API request, 2,000 characters per rich text object, and, for Free workspaces with more than one member, 1,000 lifetime blocks in total as of Nov 2026. Single-member Free workspaces and higher plans have unlimited blocks.

People search for a Notion page size limit expecting one number. There isn't one on Notion's developer pages. What you'll find instead is a set of per-request limits for the API and, for some Free workspaces, a cap on blocks. They matter in different situations, so here's each one in plain terms.

Per-request caps in Notion's API

These limits come from Notion's developer docs and apply to each request sent to the API, for example by an integration or automation that writes to Notion. They aren't a cap on how long a page can grow when you type into it.

ItemLimitApplies to
Blocks per API request1000 block elementsAny single API request
Payload size500KBEvery API request
Rich text content2000 characterstext.content in a rich text object (and text.link.url)
Equation expression1000 charactersAny equation
Elements in a block array100Any array of block types, including rich text, per request
URL2000 charactersAny URL
Email or phone number200 charactersAny email or phone value
Multi-select options, relation pages, people100 eachPer request

The relation limit is easy to misread. It caps how many pages you add or set in one request; a relation property itself can hold far more than 100 related pages. If you need to link more, send them across several requests.

What happens when a request is too big

A request that goes over a size limit returns a validation_error code with HTTP status 400 and a message describing the problem. Nothing is half-written; you split the content into smaller requests and send again. For long imports, that usually means batching blocks in groups and keeping each rich text chunk under 2000 characters.

The block limit on shared Free workspaces

This is the limit that catches small teams. Notion's developer docs say, as of Nov 2026, that Free workspaces with more than one member have a limit of 1,000 lifetime blocks. Single-member Free workspaces, and workspaces on higher plans, have unlimited blocks. Guests don't count as members for this limit.

Two details make it bite harder than it sounds. Deleting blocks doesn't restore capacity, because the count is lifetime. And creating a page counts as creating a block, so every page and database adds to the total.

How the grace period plays out

  1. The write that first reaches the block limit succeeds.
  2. That starts a three-day grace period.
  3. After the grace period expires, requests that create blocks fail, including the Create a page and Create a database endpoints.
  4. Reads, deletes and edits that create no blocks keep working.

Notion's docs on workspace block limits describe these rules for the API. The block limit applies to internal connections and OAuth connections restricted to selected workspaces, not to personal access tokens.

Rate limits sit on top

Separately from size, each connection gets 600 requests per minute on Business and Enterprise workspaces and 180 requests per minute on all other plans. A big import can hit the rate limit before it hits a size cap, so pace your requests.

If you need bigger structured data

Airtable's plans overview lists a cap on records per base that rises by plan, from 1000 records per base up to 125000. If what you're building is really a large table rather than a set of pages, that's a different shape of limit worth comparing. My guide to Notion databases covers how Notion handles structured data, and my list of Notion alternatives goes wider.

Work with me

Want AI doing the heavy lifting in your marketing?

I build the systems that handle the boring 80 percent, so you get your week back. Done properly, with the human kept in.

My advice for a growing Notion workspace

Don't worry about how long a single page gets: there's no single page cap on Notion's developer pages. Worry about the block count if you're on a Free workspace with more than one member, because it's lifetime and deleting won't help. If you're writing to Notion through the API, batch requests under 1000 blocks and 500KB, keep rich text under 2000 characters, and back off when you see a 400.

Want your tool on this list? Featured spots and reviews here are paid partnerships. Here's how to partner with me.

Frequently asked questions

Is there a maximum length for a Notion page?

Notion's developer docs don't state a single page length. They document per-request limits: 1000 block elements and 500KB per payload, and 2000 characters per rich text object.

How many blocks can a Free workspace have?

Free workspaces with more than one member have 1,000 lifetime blocks as of Nov 2026, per Notion's developer docs; single-member Free workspaces have unlimited blocks.

Does deleting blocks free up space?

No. Notion says deleting blocks doesn't restore capacity.

What happens when I hit the block limit?

The write that reaches it succeeds and starts a three-day grace period. After that, requests that create blocks fail, but reads, deletes and edits that add no blocks keep working.

What is the Notion API rate limit?

600 requests per minute per connection on Business and Enterprise, and 180 per minute on all other plans.

Published and maintained by the Lilach Bullock team, covering marketing, AI and business growth.
Your buyers are asking AI who to use. Does it say you?

See for free whether ChatGPT, Claude, Perplexity, Gemini and Google name you, and get the plan to become the answer.

Check my AI visibility →
Sundays only

Get the Sunday newsletter.

One email a week. AI experiments, marketing tactics, and the workflows Lilach is building right now in her own business.

Subscribe free

Let’s get your marketing running on AI.

Book a free 30-minute call

We figure out what you need, where AI fits in, and what working together would look like.

Book the call →

Or take the 30-second calculator

You’ll see the hours and the money quietly leaking out of your week, and the three workflows worth building first.

Take the calculator →

Or grab the free AI resource library

Prompt packs, templates, checklists, and swipe files. The exact tools I build for paying clients. Yours, free.

Get the library →
Keep reading

More from the blog.