The embedded PDF viewer macro (View File) doesn't work in Confluence

Hi All,

The macro shows only the background colour of the PDF, the text doesn't!

What we tried and did not help:

  • add underscore to filename
  • creating view in another space, on another page

The used macro is 'PDF' macro.

Confluence version: 4.2

Maybe the origon of the PDF does matter? I mean when somebody save a jpg to PDF...

Can you please suggest?

Thanks in advance!


16 answers

1 accepted

1 vote
Answer accepted
David Simpson Community Champion Jun 19, 2012

You may wish to try SharpView High-Resolution PDF Viewer for Confluence from AppFusions -- which in my opinion is a much better at rendering PDFs for viewing and reading :)

Hi David,

thanks for the suggestion but I think the official View File macro has to work. Otherwise the SharpView macro is not free so our admins won't support to purchase.

Any idea?

Hi all, same problem here with Confluence 4.3.6.

The viewer failed with PDF file version 1.6 and above. With pdf file version 1.5 and below, the viewer is ok.

When i convert files from 1.6 to 1.5, it works ... so PDF file version problem ?


Stephane, may I know which PDF converter that you're using?

I have experienced the same thing even after upgrading our Confluence version from 4.3.6 to 5.4.4.

3 years later, still having issues -- any update on this?

Hi All,

any idea? It's a very weird problem. We just upgraded our Confluence from version 3.5 to 4.2

It worked well in 3.5 but since 4.2 the problem exists.

Can you please help?

Many thanks!


We're having the same problem. Shows up with no view. I've had a few of them work..but not all. Similar to Rumi I tried different things in file naming but can't see a pattern. I think the files are being converted on the backend but I can't seem to find where they are.

at first I thought it was the version of the PDF. But no, it is not bound, the question remains for us. We fixed the problem by uploading new PDF documents, we therefore converted from different applications, such as OpenOffice (export functions), etc ... Nothing special. This requires indeed to have the source ...

This is a tricky problem (PDF formats are not as simple as they look sometimes) which is why SharpView exists - and has existed, supported for 2+ years.

So it really depends on what is your time worth.. our customers have been very happy with the product, and continue to renew.

It also has a ton of advanced browsing features, and iOS non-flash support, if you are browning from Mac/iPhone/iPad.

i just came across this very issue and was able to solve it with rasteredge's pdf viewer . also you can rendering pdf to tiff word and so on.

We just finished demoing SharpView. It's no better than the built in viewer. As a matter of fact, it's worse. At least the built in viewer will have a download link allowing customers to access the document that way. Sharpview will only have the download link once the document has rendered.

We had to remove it from our servers, and just tell people to use the download link if it doesn't render.

We are having this same problem.

Although it only occurs with some PDFs. I have tried it with other PDFs and these have been embedded and work fine within the Confluence page. This suggests to me that it may be a problem with the type of PDF being uploaded but I am not sure why or how this can be resolved.


This might be a late response, but you might find it usefull to solve your problem:

The Link Preview ( is a great Confluence Utility. You can preview PDF documents, images and webpages.

Try it now.

Best Regards,


Same here. Version 5.4.1. Although it seems to appear on older Confluence-versions and not with the current one.

Love to know whats wrong :-)

Same problem with 5.5 with some pdf. Would be nice to have it fixed soon.

Addon Link Preview for Confluence works perfectly!

But I do have to say it works best with the Default Theme and with File List-pages. But a new release is coming soon!

I'm leaning to it being a Confluence problem, not a PDF one.

I have a page that would not preview a PDF, neither with the PDF macro nor the Attachments macro. I added some very simple PDFs of varying Acrobat-readable versions, and experimented with PDF Optimization. Nothing worked.

I added the same files to my sandbox space and they previewed fine, then when I went back to the problem page, suddenly they previewed fine there. Problem solved? Not likely, but at least it worked.

Same issue here, running 

  • 5.10.7

No solution found so far ....

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,114 views 2 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