Skip to main content

Limits

We’d love for you to have unlimited joy building on Convex but engineering practicalities dictate a few limits. This page outlines current limits in the Convex ecosystem.

Many of these limits will become more permissive over time. Please get in touch if any are prohibitive for your application.

Limits are applied per team unless stated otherwise.

Business and Enterprise plans use custom resource allocations unless otherwise noted below.

Free and Starter share the same S16 provisioned performance tier. Free has hard resource caps, while Starter can exceed its included resource amounts with usage-based pricing.

Unless otherwise noted, pricing quoted on this page is for US regions. EU region pricing is 1.3x.

Team

Free/StarterProfessionalBusinessEnterprise
Developers1-61-201-50Unlimited
Deployments40300UnlimitedUnlimited

Database

Free/StarterProfessionalBusinessEnterpriseNotes
StorageFree: 0.5 GB total
Starter: 0.5 GB included;
$0.22/month per additional GB
50 GB included;
$0.20/month per additional GB
Serverless: $0.20/month per GB
Dedicated: $0.45/month per GB
Serverless: $0.20/month per GB
Dedicated: $0.45/month per GB
Includes database rows and indexes but not files or backups.
Database I/OFree: 1 GB/month total
Starter: 1 GB/month included;
$0.22 per additional GB
50 GB/month included;
$0.20 per additional GB
Serverless: $0.20 per GB
Dedicated: $0.15 per GB
Serverless: $0.20 per GB
Dedicated: $0.15 per GB
Document and index data transferred between Convex functions and the underlying database.
Tables10,00010,00010,00010,000Per deployment.
Indexes per table32323232
Fields per index16161616
Index name length64 characters64 characters64 characters64 characters

Restrictions

  • Table and index names must be valid identifiers and cannot start with an underscore.

Documents

Applied per document and to any nested Object unless stated otherwise.

Notes
Size1 MiB
Fields1024The number of fields/keys
Field name length64 charactersNested Object keys can have length up to 1024 characters.
Field nesting depth16How many times objects and arrays can be nested, e.g. [[[[]]]]
Array elements8192

Restrictions

  • Field names must only contain non-control alphanumeric ASCII characters and underscores and must start with an alphabetic character or underscore.
  • Documents cannot contain top-level fields that start with an underscore, other than the system-provided _id and _creationTime fields.
  • Strings must be valid Unicode sequences with no unpaired surrogates.

Functions

Free/StarterProfessionalBusinessEnterpriseNotes
Function callsFree: 1,000,000/month total
Starter: 1,000,000/month included;
$2.20 per additional 1,000,000
25,000,000/month included;
$2 per additional 1,000,000
Serverless: $2 per 1,000,000
Dedicated: $0.20 per 1,000,000
Serverless: $2 per 1,000,000
Dedicated: $0.20 per 1,000,000
Explicit client calls, scheduled executions, subscription updates, and file accesses count as function calls.
Query / mutation computeFreeFreeServerless: Free
Dedicated: $0.45/GB-hour
Serverless: Free
Dedicated: $0.45/GB-hour
Query and mutation compute is only billed on dedicated deployments.
Action computeFree: 20 GB-hours/month total
Starter: 20 GB-hours/month included;
$0.33/GB-hour additional
250 GB-hours included;
$0.30/GB-hour additional
Convex runtime: $0.16/GB-hour CPU time
Node.js runtime: $0.32/GB-hour
Convex runtime: $0.16/GB-hour CPU time
Node.js runtime: $0.32/GB-hour
Convex runtime: 64 MiB RAM.
Node.js runtime: 512 MiB RAM.
Code size32 MiB32 MiB32 MiB32 MiBPer deployment.
Function argument size16 MiB16 MiB16 MiB16 MiBNode actions only support arguments up to 5MiB.
Function return value size16 MiB16 MiB16 MiB16 MiB
HTTP action response size20 MiB20 MiB20 MiB20 MiBThere is no specific limit on request size
Length of a console.log line4 KiB4 KiB4 KiB4 KiB
Log streaming limits4096 logs, flushed every 10 seconds4096 logs, flushed every 10 seconds4096 logs, flushed every 10 seconds4096 logs, flushed every 10 secondsHow many logs can be buffered when streaming

Deployment Classes

Convex has three deployment classes that each have different concurrency limits. These limits are meant to scale as your traffic grows.

S stands for serverless and D stands for dedicated. Dedicated deployments run on their own exclusive database hardware.

The number represents the number of concurrent queries that can be running on a deployment at a given time. As the concurrent query limit gets larger, other internal limits are scaled proportionately to allow your deployments to handle larger workloads.

Below are the deployment classes that each plan has access to:

  • Free/Starter: S16
  • Professional: S256
  • Business: S16, S256, or D1024
  • Enterprise: S16, S256, or D1024

Free, Starter, and Professional are limited to a single deployment class, while Business and Enterprise can choose their class on a per-deployment basis.

Capabilities

S16S256D1024
Concurrent sessions1,00010,000100,000
Query cache1 GB shared1 GB shared2 GB dedicated
Max dataset1 TB1 TB4 TB
Backup/restoreLogicalLogicalHigh-speed physical
SLA (Business/Enterprise only)99.9%99.9%99.95%

Concurrent Function Executions

Number of functions you can run at a time for each function type.

S16S256D1024*
Queries162561024
Mutations16256512
Mutation write throughput limit4 MiB8 MiB32 MiB
Convex runtime actions and HTTP actions645121024
Node actions642561024
Scheduled jobs8256512

* Limits can be increased for Business and Enterprise plan customers on a case-by-case basis. Send us a support message through the dashboard to discuss your needs. Usually this is only needed if your product has highly bursty traffic.

Execution time and scheduling

Notes
Query/mutation execution time1 secondLimit applies only to user code and doesn’t include database operations.
Action execution time10 minutes
Scheduled functions1000The number of other functions a single mutation can schedule.
Scheduled function argument size4 MiB
Total size of all scheduled function arguments scheduled in a single mutation16 MiBApplies only to functions scheduled from mutations, not actions.
Concurrent IO operations per function1000The number of IO operations a single function can perform, e.g., a database operation, or a fetch request in an action.
Outstanding scheduled functions1,000,000

Transactions

These limits apply to each query or mutation function. To ensure you're within the limits, there are tools to calculate and limit consumption within a transaction.

Notes
Data read16 MiBData not returned due to a filter counts as scanned
Data written16 MiB
Documents scanned32,000Documents not returned due to a filter count as scanned
Index ranges read4,096The number of calls to db.get and db.query.
Documents written16,000
Function return value size16 MiB

Environment Variables

Applied per-deployment.

Number of variables1000
Maximum name length40 characters
Maximum value size8 KiB

File Storage

Free/StarterProfessionalBusinessEnterpriseNotes
StorageFree: 1 GB total
Starter: 1 GB included;
$0.033/month per additional GB
100 GB included;
$0.03/month per additional GB
$0.03/month per GB$0.03/month per GBIncludes user files and backups.
Data egressFree: 1 GB/month total
Starter: 1 GB/month included;
$0.132 per additional GB
50 GB/month included;
$0.12 per additional GB
$0.12 per GB$0.12 per GBIncludes serving user files, accessing user files inside functions, and generating and restoring backups.

Search pricing

Free/StarterProfessionalBusinessEnterpriseNotes
Search storageFree: 0.5 GB total
Starter: 0.5 GB included;
$0.55/month per additional GB
1 GB included;
$0.50/month per additional GB
$0.50/month per GB$0.50/month per GBShared by text and vector search indexes.
Search queriesFree: 3,000 query-GBs/month total
Starter: 3,000 query-GBs/month included;
$0.11 per additional 1,000 query-GBs
50,000 query-GBs/month included;
$0.10 per additional 1,000 query-GBs
$0.10 per 1,000 query-GBs$0.10 per 1,000 query-GBsShared by text and vector search queries.
Value
Search indexes per table4
Filters per search index16
Terms per search query16
Filters per search query8
Maximum term length32 B
Maximum result set1024
Value
Vector indexes per table4
Filters per vector index16
Terms per search query16
Vectors to search by1
Dimension fields1 (value between 2-4096)
Filters per search query64
Maximum term length32 B
Maximum result set256 (defaults to 10)

If any of these limits don't work for you, let us know!

Please see our Free, Starter, and Professional pricing page and Business and Enterprise pricing page for current resource limits. After these limits are hit on the Free plan, new mutations that attempt to commit more insertions or updates may fail. Starter, Professional, Business, and Enterprise plans can exceed their included resource amounts with usage-based pricing, subject to deployment-class limits.