Key concepts

Renders

Rendering always rasterizes a template's live draft — whatever currently stands in the studio, not a separately published version. This is deliberate: there is no separate “publish” step, so what you see in the editor is always what the API returns.

A render can produce a single page or every page at once (allPages), and in one of three formats: png, jpeg, or pdf. Requesting allPages with a raster format produces one file per page; with pdf it produces a single multi-page file.

An identical render — same template draft, same modifications, same idempotencyKey — is served from the existing file instead of rendering again, and costs no additional credit. This makes retries safe.

Every render is stored and returned as a hosted URL, along with its pixel dimensions and byte size. Renders can be listed from the dashboard's Renders page for auditing.