Skip to main content
Oviond renders any report as a PDF on demand. Generation runs asynchronously in the background, so large reports don’t block your browser — Oviond queues a job, renders the report headlessly, and stores the finished file for download.

​
Generate a PDF

1

Open the share dialog

From the project, open Share and switch to the Download tab.
2

Click Generate New PDF

Oviond queues a generation job. The button shows Generating (or a queued count) while it works, and a new entry appears in the Download History list in a processing state.
3

Download

When the job completes, the history row flips to a success state and a Download link appears. Use the trash icon to remove an export and its stored file.
The list reflects each generation attempt’s state — processing, completed, or failed.

​
How it works

Generation is a two-step asynchronous flow:
  1. POST /v1/pdf/generate validates the request and enqueues the job, returning a job_id. The request specifies the project_id, client_id, a page format (A4 or Letter), and orientation (portrait or landscape). The defaults are A4 and portrait.
  2. GET /v1/pdf/status/:job_id is polled until status is complete (which returns the file url) or failed.
Each attempt is recorded in the project’s export history, which the Download History list reads from.
PDF generation requires Oviond’s file storage (S3) to be configured. If it isn’t, the generate request is rejected.

​
Troubleshooting

Generation fails or times out — Very large reports with many widgets can occasionally fail to render. Try again, or split the report across more pages. Failed attempts show a failed state in the history list. Images or logos missing — Make sure all image URLs in your report are publicly accessible. Private or expired URLs won’t render in the headless browser.