Troubleshooting

Export Fails or Doesn't Download

Symptom: Clicking Export does nothing, or the export starts but no file downloads.

Steps to resolve:

1. Check your browser's download settings — some browsers block automatic downloads
2. Disable any browser extensions that may block downloads (ad blockers, privacy tools)
3. Check the browser console for errors (F12 → Console)
4. Try exporting a single, simple page to rule out content-related issues
5. Try in a different browser

---

Images Missing from Export

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:

1. Confirm the template has Cover Page toggled to enabled
2. Confirm the export is using the correct template (check the template dropdown)
3. 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:

1. Confirm the template has Table of Contents enabled
2. 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.
3. Verify the exported pages actually contain heading elements (H1, H2, H3) — plain paragraph text does not generate TOC entries

---

Watermark is Not Visible

Symptom: Watermark is enabled in the template but doesn't appear in the PDF.

Steps to resolve:

1. Check the Opacity setting — if set very low (below 0.05) the watermark may be invisible. Set it to 0.15 or higher.
2. Confirm Watermark Text is not empty
3. Save the template and retry

---

Page Numbers are Missing

Symptom: Page numbers are enabled in the template but don't appear.

Steps to resolve:

1. Open the template and confirm Page Numbers is toggled on
2. Check the Position setting — ensure it's not conflicting with a footer that occupies the same area
3. Note: the cover page does not display page numbers. Check the second page onward.

---

Template Not Visible to Users

Symptom: A template exists in admin settings but users don't see it in the dropdown.

Steps to resolve:

1. Check if the template has been archived — archived templates are hidden from users. Restore it to make it active.
2. Confirm the template was saved successfully (no unsaved draft)

---

The Exporter Is Missing From the Page

Symptom: There's no Export to PDF under the page title, or the More actions (···) menu doesn't show PDF Exporter for Confluence.

Steps to resolve:

1. Go to Confluence Settings → Manage apps and confirm the app is Enabled
2. Refresh the page and try again
3. 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:

1. Confirm at least one page is checked in the page selection tree
2. Check that the selected pages have viewable content (not empty pages)
3. Try a different template to rule out a template configuration issue

---

My Export Says "Waiting in Line"

Symptom: A background export shows Waiting in Line, or Waiting in My exports, instead of progress.

What's happening: server exports run one at a time per site, and another export (someone else's, a scheduled run or an API export) is running. The card shows how many exports are ahead of yours.

What to do:

1. Nothing: it starts by itself when the exports ahead of it finish. You can close the page and download it later from My exports
2. If you no longer need it, click Cancel export on the card, or Cancel in My exports
3. For a small export you need right now, set Where to generate to This browser

---

"Server-Export Pages" Used Up for This Month

Symptom: An export is refused with This site has used all 10,000 server-export pages for this month, or only N server-export pages are left this month.

What's happening: each site can render 10,000 pages a month on the server. Exports built in the browser don't count.

What to do:

1. Export up to 30 pages at a time in your browser: set Where to generate to This browser
2. Wait for the reset date in the message (the first day of next month, UTC)
3. Admins can see the month's use under Server exports this month in Confluence Settings → PDF Exporter → Exports & storage

Scheduled and API runs that don't fit fail with the same reason, shown on the schedule's card or in the token's Recent calls.

---

"A New Version Is Waiting for Approval" or "Update Required"

Symptom: The exporter shows A new version of PDF Exporter is waiting for approval, admins see Update required in the settings, or Schedules says An app update needs approval.

What's happening: scheduled exports, the REST API and attaching exports to pages need permissions from the latest major version, which a Confluence admin has to approve. Exporting keeps working until then.

What to do: a Confluence admin goes to Settings → Manage apps, finds PDF Exporter for Confluence and selects Update. On some sites the request is under admin.atlassian.com → Apps → Connected apps. See Approve the Latest Update.

---

A Scheduled Export Paused or Failed

Symptom: A schedule shows Paused, or "Last run failed".

Steps to resolve:

1. Read the reason on the schedule's card (Apps → PDF Exporter → Schedules)
2. Archive page was deleted — choose a new archive page with Edit, then Resume
3. The schedule owner can no longer edit the archive page — restore the owner's edit permission, or have someone else create the schedule
4. The schedule owner is no longer active — delete the schedule and create it again as an active user
5. Click Run now to check the fix straight away

---

No Email After a Scheduled or API Export

Symptom: The export finished, but nobody was emailed.

Steps to resolve:

1. Check that Notify by email is on (schedules), or that mention and attachTo were sent (API)
2. Check the archive page for the app's comment. Schedules reply in one thread per schedule, so look for the newest reply under the schedule's first comment. If it's there, the mention was sent
3. Recipients must be able to view the archive page, and have Confluence email notifications turned on in their profile settings

---

API Request Returns 202 but No File Appears

Symptom: The REST API accepted the request, but nothing shows up.

Steps to resolve:

1. Wait a few minutes — large exports take a while
2. Open Confluence Settings → PDF Exporter → API, then the token's Recent calls: it shows started, done, or why the export failed
3. Look in the token owner's My exports — exports land there, not in the caller's

---

Still Having Issues?

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