PDF Export
Greppilot can export any dashboard to a multi-page PDF document directly from your browser. The export captures all charts, tables, and content blocks exactly as they appear on screen, with support for custom page breaks, page sizes, and theme selection.
How It Works
PDF export runs entirely client-side — no data leaves your browser. The process:
- The dashboard grid is captured as a high-resolution image (2x pixel ratio).
- UI-only elements (edit buttons, tooltips, drag handles) are stripped from the capture.
- The image is sliced into pages based on your page break positions.
- Pages are assembled into a PDF using the selected page size and theme.
Because the export is client-side, what you see on screen is exactly what ends up in the PDF. Make sure your dashboard looks right before exporting.
Exporting a Dashboard
- Open the dashboard you want to export.
- Click the Download button (arrow icon) in the dashboard header.
- In the export dialog, choose your options:
- Page Size: A4 or Letter
- Theme: Dark or Light
- Click Export PDF.
- A progress indicator shows the current page being rendered. The PDF downloads automatically when complete.
Page Breaks
By default, Greppilot automatically computes page break positions to avoid splitting components across pages. You can also set manual page breaks for precise control over how your dashboard is paginated.
Automatic Page Breaks
The auto-break algorithm:
- Calculates how many grid rows fit on a page based on the selected page size.
- Places breaks at row boundaries, preferring gaps between components.
- Avoids splitting a component across two pages when possible.
- Falls back to a forced break for components taller than a single page.
Manual Page Breaks
To customize page breaks:
- Enter the page break editor by interacting with the dashboard in export mode.
- Purple dashed lines appear at each break position, labeled with page numbers.
- Drag a break line up or down to reposition it (snaps to row boundaries).
- Remove a break by clicking the X button on the break line.
Page breaks are saved with the dashboard. Once you set them up, they persist across sessions — you don't need to reconfigure them each time you export.
How Page Breaks Are Stored
Page breaks are stored as an array of row numbers on the dashboard object. They're persisted to the database and included in the dashboard API response.
| Field | Type | Description |
|---|---|---|
pageBreaks | array<number> | Array of grid row positions where pages should break. An empty array means auto-breaks will be computed at export time. |
You can update page breaks by asking the agent to adjust the layout, or by using the dashboard settings panel to configure where pages should break.
Export Options
| Option | Values | Description |
|---|---|---|
| Page Size | a4, letter | Paper size for the PDF. A4 is 794x1123px, Letter is 816x1056px. |
| Theme | dark, light | Export with the dark theme (matching the default UI) or a light theme with white background. |
Technical Details
- Resolution: Captured at 2x pixel ratio for crisp output on high-DPI displays.
- Margins: 40px on all sides of each page.
- Stripped elements: Edit controls, tooltips, and drag handles are excluded from the PDF — only your charts, tables, and content blocks are captured.
- Chart colors: Charts are re-themed to match your selected export theme (dark or light).
Very large dashboards with many charts may take a few seconds to render. The progress indicator shows which page is being processed. Avoid interacting with the dashboard during export.