How can I control image quality in a PDF export?

We recently generated an entire users manual for one of our products as a Confluence (v4.1) space. It looks great - until we do a PDF export. Many of the screenshot images in the export appear to have been resampled. Some of the text in the images is now unreadable. I know we can work around some of this by carefully choosing the size of our original images, narrowing the scope of the image, etc. But what I am wondering is this:

Are any settings in Confluence or in the PDF stylesheet (or anywhere else, for that matter) that we can use to modify how the images are being resized/resampled during conversion to PDF?

5 answers

1 accepted

You might want to try tweaking this CSS bit in your PDF Stylesheet (the following are the default PDF export CSS that can be found from confluencedefaultpdf.css):

   page-break-inside: avoid;

Hi Husein,

Thanks for responding! I'll look into this ASAP. Are there any other image related parameters I might look at? I've never worked with stylesheets before, and poking around on line is hard when I don't have decent keywords to search for...



Hi Husein, this option only changes the size of the images not the quality. Regards Thomas

We had a lengthy discussion about image quality in PDF export at

It developed quite a bit so it can be confusing. Bottomline is you need very big images on the wiki page to get good images in the PDF. Using thumbnails to make the images smaller often causes even worse results in the PDF. But there is some kind of a workaround...

Can you explain in details about workarounds ?

Follow the above link. The information is in the other thread.

Suggest an answer

Log in or Sign up to answer
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Kesha Thillainayagam
Posted Friday in Confluence

We want to hear how your non-technical teams are using Confluence!

Hi Community! Kesha (kay-sha) from the Confluence marketing team here! Can you share stories with us on how your non-technical (think Marketing, Sales, HR, legal, etc.) teams are using Confluen...

278 views 11 10
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you