Build limits and quotas

Mintlify build limits, concurrent deployments, and what to do when you hit them.

Mintlify imposes some limits on deployments to keep the build infrastructure reliable for all customers.

Concurrent builds

By default, a project can have one active build at a time. If a new push arrives while a build is in progress, Mintlify queues the new build and starts it when the current one finishes.

For high-velocity teams that push frequently, this means two rapid pushes may result in one of them being built after a short wait.

Build frequency

There’s no hard limit on how many deployments you can trigger per day, but very frequent deployments (many per minute) may be rate-limited temporarily. If you’re triggering programmatic deployments, add a delay between requests.

Large repositories

Build times scale with the number of pages in your docs site. Most sites with fewer than 1,000 pages build in under a minute. Very large sites (thousands of pages) may take a few minutes.

To reduce build times:

• Avoid generating pages dynamically from external sources — pre-render content where possible.
• Keep images optimized — large image files slow down builds and page loads.

Plan limits

Starter plans are limited to one project. Growth and Enterprise plans support multiple projects. Check Settings → Billing for the limits on your current plan.

If you’re consistently hitting build quotas or need higher concurrency, contact support — Enterprise plans include custom limits.