• Products
  • Documentation
  • Resources

Cases where PDF Export may revert to using legacy exporter

In Q2 2023 we released an update to PDF export that renders Confluence pages more accurately. However, this update does not support all use cases. In some cases, exports will revert to using the older method of PDF export.

Watch our progress on export features:

  • CONFCLOUD-75975 - Support @page tags in single page PDF exports and IP allowlisting for new PDF export experience 

  • CONFCLOUD-76035 - Support @page tags with @top-right, @top-left etc properties, header/footer/title HTML, and IP allowlisting in space PDF exports for new PDF export experience

  • CONFCLOUD-76314 - Support space PDF exports above 2000 pages or 1000 attachments

This page explains when your PDF export may revert to using an older version of the exporter that might not render content as accurately.

Image of components in PDF export feature on Confluence

Page PDF Export

Page PDF Export will fall back to the legacy exporter if:

  • IP Allowlisting Enabled

  • @page tags are detected in the PDF stylesheet (for space OR site settings)

Space PDF Export

Space PDF Export will fall back to the legacy exporter if:

  • IP Allowlisting Enabled

  • @page tags with @top-right, @top-left etc properties detected in the PDF stylesheet or header/footer/title HTML (space OR site settings)

  • You’re exporting more than 2000 pages in the space or 1000 attachments - we recommend that you split the space to export

How do I determine which version of PDF export is being used?

  • Page PDF export

    • V1 Legacy PDF

      • Progress bar goes from 0 to 100 directly

      • In inspect network tab in developer tools it shows network calls with runningtaskxml.action to get progress

    • V2 New PDF

      • Progress bar goes from 0-25-75-100

      • In inspect network tab in developer tools it shows network calls with progress  to get progress

  • Space PDF export

    • V1 Legacy PDF

      • Progress bar shows text like Converted 33 pages of 44 to intermediate HTML

      • In inspect network tab in developer tools it shows network calls with runningtaskxml.action to get progress

    • V2 New PDF

      • Progress bar doesn't show any text

      • In inspect network tab in developer tools it shows network calls with progress  to get progress

Learn more about PDF export customizations and exporting content to PDF, CSV, HTML, and XML.

 

Additional Help