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
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

1,603 views 4 13
Read article

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