What are the best practices for creating PDF snapshots of Klips and Klip dashboards?

PDFs are generated by rendering your Klip or dashboard in a virtual web browser at a specific viewport (virtual window) size, applying PDF-specific CSS, creating an image, and then delivering it as a PDF file.

You may want to experiment with different configurations to determine what options work best for the snapshot you're trying to generate.


Portrait or landscape layout will determine the width at which your Klip or dashboard is rendered when it is converted to a PDF.


Klip: Rendered at 900px

Dashboard: Rendered at 1000px


Klip: Rendered at 1200px

Dashboard: Rendered at 1300px

To see how your PDF will look, resize your browser---in full screen TV mode to minimize empty space on either side---and observe the layout.


Not all Klips or dashboards are well-suited to the same page sizes. Try different size settings to make sure your content fits well.

Fit to One Page

Force the rendered Klip or dashboards to fit on one page in the specified layout. This is handy if your dashboard isn't too big and you want to make sure it's a single page.

Multiple Pages

Use this setting if your Klip or dashboard is quite large. Klipfolio will try to move Klips in a dashboard layout to prevent them from being bisected by page breaks.

Multiple Pages (no breaks)

Use this setting if you've preconfigured your dashboard layout to avoid breaks.


The height of your Klip or dashboard as rendered in a PDF is based on its content.

Approximate heights:

Portrait: 1150px

Landscape: 920px


Comments are rendered below a Klip or the entire dashboard and are optional.


The quality setting affects the file size of the rendered image and therefore the file size of the final PDF.

Note: Some HTML and Image components may not render on PDFs if they take too long to load.



Cascading style sheets are used by Klipfolio to change the rendering style of Klips and dashboards  to better suit PDF and printed formats. Elements like borders, buttons, resize handles, and drop shadows are hidden. Color and padding are used to differentiate between Klips.

Customers, including those with custom themes and white-label account settings, cannot modify the styles applied to PDFs before generation.

Pro Tip

If you really, really, really want to see what your PDF will look like before it’s turned into a PDF, and you understand how to add classes and override CSS using your browser’s inspector, use this CSS file and add the imaging-ctx-save_as_pdf and imaging-target-tab classes to the element with the id kfdashboard.

Make sure your browser is close to the appropriate dimensions (ex. for a dashboard in landscape, 1300px by 920px), and in full screen mode.

Have more questions? Submit a request