What 1mb limit convex has?

[steel plinth]

I got this error: Uncaught Error: Value is too large (1.01 MiB > maximum size 1 MiB) at async handler (../convex/workflowHelpers.ts:317:50). What is that?

[drowsy shadow]

Hi @steel plinth. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:

---

That error is Convex’s value size limit.

Convex values (anything you pass as arguments, return from functions, store in the DB, or pass through workflows) must be < 1 MiB total size. If a single value is larger, Convex throws an error like the one you’re seeing. [Data type limits]

In your case it’s happening inside a workflow, and workflows also have a 1 MiB limit on the total data a step takes in and returns during a single execution. [Workflow limits]

So:

• You’re trying to pass or return a value of about 1.01 MiB, which exceeds the 1 MiB Convex value limit.
• To fix it, you need to:
  • Store large data in the database or file storage and pass around IDs/references instead of the full object, or
  • Break the data into smaller chunks so each value is under 1 MiB.

You can measure sizes in code with getConvexSize from convex/values if needed. [values module; Data type limits]

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: