Guarantees

Limits & quota

Renderly usage is metered per organization, with a monthly quota defined by your plan. Here are the quota limits, the output formats, the page sizes and the limits of the verification endpoint.

Monthly quota

The quota is the number of successful renders an organization can make per month. It is counted per organization (not per key): all of the organization’s API keys count toward the same limit. The count resets at the turn of the month (UTC).

Plan	Monthly quota	Verification mark
Free (beta)	500 renders/month	Always on
Pro	5,000 renders/month	Always on
Business	25,000 renders/month	Always on
Enterprise	Custom	Co-branding

What counts toward the quota

Only renders completed successfully consume quota. Requests that fail with a client error (401, 404, 422) do not count. The verification endpoint (/api/verify) is free and does not consume quota.

When the quota runs out

Once the limit is reached, new calls to /v1/render respond with 402 quota_exceeded until the turn of the month. Need more quota in the beta? Talk to us.

402 quota_exceeded

{
  "error": {
    "code": "quota_exceeded",
    "message": "Beta quota (500 renders/month) reached. Need more? Talk to us: suporte@renderly.dev"
  }
}

Track your usage

See how many renders you have used this month in the Dashboard — the count is per organization and resets at the turn of the month (UTC).

Output formats

The format field accepts two values. The default is pdf.

format	Content-Type	Typical use	Options
`pdf`	`application/pdf`	Invoices, contracts, receipts, reports.	A `pdf` object (size, margins, scale).
`png`	`image/png`	Thumbnails, social posts, previews.	A `png` object (dimensions, fullPage).

The details of each options object are in Render endpoint.

Page sizes (PDF)

For PDF, pageFormat accepts five standard sizes. The default is A4. Orientation is controlled by landscape.

pageFormat	Approximate size	Where it’s common
`A4`	210 × 297 mm	Standard in Brazil and Europe (default).
`Letter`	216 × 279 mm	Standard in the US.
`Legal`	216 × 356 mm	Legal documents (US).
`A3`	297 × 420 mm	Posters, blueprints, wide tables.
`A5`	148 × 210 mm	Flyers, compact receipts.

Verification endpoint limits

The /api/verify endpoint is public and free, but has a file-size cap to protect the service.

Limit	Value	Error when exceeded
Maximum file size	25 MB	`413 too_large`
Empty body	—	`400 empty`

Render time

Rendering is synchronous: ~10ms on the native engine (editor templates) and up to ~1s on Chromium (raw HTML). Heavy documents (many pages, large images, external resources) take longer. Set a timeout of 60s on your HTTP client to accommodate the slowest cases without aborting too early.

The engine affects timing

Documents that run on the native engine tend to be faster and more deterministic; those that go through chromium (raw HTML, PNG, complex layouts) can vary more. The X-Render-Ms header reports the actual duration of each call.

Limits summary

Resource	Limit
Render quota	Monthly, per organization, by plan
Formats	pdf, png
Page sizes	A4, Letter, Legal, A3, A5
PDF scale	0.1 to 2
Verification upload	Up to 25 MB
Recommended timeout	60s on the client

To see your plan’s quota and current usage, open the Dashboard. To handle the 402 in code, see Errors.

Back to the overview

Review the concepts or jump to another section from the sidebar.