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

This widget could not be displayed.

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...



This widget could not be displayed.
Hi Husein, this option only changes the size of the images not the quality. Regards Thomas
This widget could not be displayed.

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...

This widget could not be displayed.

Can you explain in details about workarounds ?

This widget could not be displayed.

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

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Sep 17, 2018 in Confluence

Why start from scratch? Introducing four new templates for Confluence Cloud

Hi my Community friends!  For those who don't know me, I'm a product marketer on the Confluence Cloud team - nice to meet you! For those of you who do, you know that I've been all up in your Co...

547 views 7 6
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