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.