NEW: Best practices for generating PDF reports

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 report 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


Annotations 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.


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.

Dashboard management

  1. Beta: Free public links
  2. Publish links
  3. NEW: What’s the difference between viewing a dashboard in the app and viewing a published link to a dashboard?
  4. Use RiseVision to display your Klipfolio dashboard on big screen TVs or digital wallboards
  5. Updates to Klipfolio user permissions
  6. Generate a Klipfolio API Key
  7. Push API deprecation, October 30, 2015
  8. Klipfolio is rebranding
  9. NEW: Best Practices for Large Screen Dashboard Display
  10. Guide to displaying Klipfolio Dashboards on a Large Screen Display
  11. Dashboard design considerations
  12. NEW: Working with Company Properties
  13. Authenticating with Google
  14. Adding a custom role and users
  15. Adding new users
  16. Annotations
  17. Building dashboards
  18. Checklist for adding new users
  19. Creating groups and setting default dashboards
  20. NEW: Removing a Klip, dashboard or data source from the Library
  21. Displaying Klips in full screen mode
  22. Downloading a Klip to your computer
  23. Downloading a dashboard and all of its Klips to your computer
  24. Whitelist IP Addresses
  25. Emailing a Klip
  26. Emailing a dashboard and all of its Klips
  27. Sending Scheduled Email Reports of Klips with variables
  28. Embedding a Klip into an HTML page
  29. NEW: Best practices for generating PDF reports
  30. Options for launching Klipfolio
  31. Removing a user from a custom role
  32. Removing a custom role
  33. Setting up an IP address range in Klipfolio
  34. Sharing data sources
  35. Sharing Klips
  36. Sharing dashboards
  37. Dashboard permalinks
  38. User properties
  39. User roles and access permissions
  40. Viewing data source failures and refresh history for an account

Feedback and Knowledge Base