Skip to main content
Oviond renders a Multi-Page Report or a Dashboard 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.
A Multi-Page Report prints page by page. A Dashboard has no page boundaries, so it prints as one long page sized to the whole dashboard — nothing is split across pages.

Generate a PDF

1

Open the share dialog

From the report, 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 report_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 report’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.