# Preview versus a real render

Compare preview and render requirements, quota usage, and output storage.

You can inspect a document inside the editor or generate a PDF to download and use. **Preview** supports design work; **rendering** creates a job with a status, history, and output file. Choose based on the task you need to complete.

## 1. Preview while editing

Use **Layout** and **PDF** in the editor to inspect structure and pagination. Draft versions can be previewed without publication.

Preview does not consume successful-render quota or create a retained PDF entry in Renders. Resource and processing-time limits still apply.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Editor → Layout / PDF for design previews">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Editor</strong><div class="wf-actions"><span class="sim-control sim-focus">PDF</span></div></div><div class="sim-tabs"><span class="">Layout</span><span class="sim-active">PDF</span></div><div class="wf-canvas"><div class="wf-paper"><b>Tembuilder</b><strong>Document</strong><i></i><i></i><i></i><i></i><small>1 / 1</small></div></div></div></div>
<figcaption>Editor → Layout / PDF for design previews</figcaption>
</figure>

**Layout** reflects your current edits. **PDF** renders saved template content, so save the design and regenerate PDF preview after changes. Preview parameters come from the editor’s values, initially Defaults; values entered in Run apply only to Run jobs. A previous PDF preview does not refresh automatically.

## 2. Render when you need an output file

Use **Run** or the render API to generate a PDF. The version must be published, and the key needs `template:render` permission in the same project.

A successful job counts toward quota, appears in Renders, and has downloadable output during its retention period. Run inside the editor creates this same type of job.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Published version + data → Render → PDF">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>RUN</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class=""><span>Version 2</span><small>Published</small></div><div class=""><span>Parameters</span><small>{ recipient: &quot;Tembuilder&quot; }</small></div></div><div class="sim-form-footer ds-pad"><span class="sim-control sim-focus sim-dark">Render</span></div></div></div>
<figcaption>Published version + data → Render → PDF</figcaption>
</figure>

## 3. Choose the right route for each step

| Task | Use |
| --- | --- |
| Edit typography, margins, content, or breaks | Editor preview. |
| Test data against a published version | Run. |
| Generate PDFs from your software | Render API. |
| Find a job’s output or error | Renders. |

To try a job without building an integration, start with [Run](/docs/renders/playground/).

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Preview supports editing · Run creates a recorded PDF job">
<div class="sim-stage"><div class="ds-columns"><div class="sim-panel"><div class="ds-head"><strong>Preview</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>Draft</span><small>✓</small></div><div class=""><span>Renders</span><small>—</small></div></div></div><div class="sim-panel"><div class="ds-head"><strong>Run</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>Published</span><small>✓</small></div><div class=""><span>Renders</span><small>✓</small></div></div></div></div></div>
<figcaption>Preview supports editing · Run creates a recorded PDF job</figcaption>
</figure>

## 4. When preview works but Run does not

Compare the version open in the editor with the one selected in Run: the selections can differ. Then check publication status, the selected key, and input values.

If a job was accepted, open its result in Renders for the specific error. Acceptance does not mean the PDF is finished; download it once status is `success` and output is available.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Match the version in Run to the published edition">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>RUN</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">VERSION</small><span class="sim-input wf-select sim-focus">v2<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div><small class="sim-label">VARIANT</small><span class="sim-input wf-select">Standard<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div></div></div></div>
<figcaption>Match the version in Run to the published edition</figcaption>
</figure>
