Troubleshooting
Symptom: Clicking Export does nothing, or the export starts but no file downloads.
Steps to resolve:
- Check your browser's download settings — some browsers block automatic downloads
- Disable any browser extensions that may block downloads (ad blockers, privacy tools)
- Check the browser console for errors (F12 → Console)
- Try exporting a single, simple page to rule out content-related issues
- Try in a different browser
Symptom: Opening the exporter shows a license error or "unlicensed" screen.
Steps to resolve:
- Go to Confluence Settings → Manage apps
- Find PDF Exporter for Confluence
- Check the license status — if expired, click Renew or Buy now
- If the license appears active but the error persists, try uninstalling and reinstalling the app (your templates will be lost)
Contact support if the issue continues.
Symptom: The exported PDF is missing images that appear on the Confluence page.
Common causes and fixes:
| Cause |
Fix |
| Image is hosted on an external server that blocks requests |
Re-upload the image as a Confluence attachment instead of using an external URL |
| Image requires authentication to access |
Use Confluence-hosted attachments |
| Very large image causing timeout |
Compress or resize the image before embedding |
Cover Page Not Appearing
Symptom: Exports don't include a cover page even though it's configured.
Steps to resolve:
- Confirm the template has Cover Page toggled to enabled
- Confirm the export is using the correct template (check the template dropdown)
- Save the template again and retry the export
Table of Contents is Empty or Missing
Symptom: The TOC page appears but has no entries, or is absent entirely.
Steps to resolve:
- Confirm the template has Table of Contents enabled
- Check the Depth setting — if set to 1 and the page only has H2/H3 headings, the TOC will appear empty. Increase depth or add H1 headings.
- Verify the exported pages actually contain heading elements (H1, H2, H3) — plain paragraph text does not generate TOC entries
Symptom: Watermark is enabled in the template but doesn't appear in the PDF.
Steps to resolve:
- Check the Opacity setting — if set very low (below 0.05) the watermark may be invisible. Set it to 0.15 or higher.
- Confirm Watermark Text is not empty
- Save the template and retry
Page Numbers are Missing
Symptom: Page numbers are enabled in the template but don't appear.
Steps to resolve:
- Open the template and confirm Page Numbers is toggled on
- Check the Position setting — ensure it's not conflicting with a footer that occupies the same area
- Note: the cover page does not display page numbers. Check the second page onward.
Symptom: A template exists in admin settings but users don't see it in the dropdown.
Steps to resolve:
- Check if the template has been archived — archived templates are hidden from users. Restore it to make it active.
- Confirm the template was saved successfully (no unsaved draft)
Symptom: The More actions (···) menu doesn't show the Export to PDF option.
Steps to resolve:
- Go to Confluence Settings → Manage apps and confirm the app is Enabled
- Refresh the page and try again
- Check if the license has expired
- Try clearing browser cache and reloading
PDF is Blank or Contains Only the Cover Page
Symptom: The PDF downloads but contains no content (or only the cover page).
Steps to resolve:
- Confirm at least one page is checked in the page selection tree
- Check that the selected pages have viewable content (not empty pages)
- Try a different template to rule out a template configuration issue
If the problem is not listed above or the steps didn't resolve it:
- Check the FAQ for additional guidance
- Contact us through the support portal with a description of the issue, the steps to reproduce it, and your Confluence site URL
