Embedding PDFs in Confluence

A PDF attachment is easy to miss: readers have to notice it, download it and open it somewhere else. Embedding it puts the document on the page, where people actually read.

Confluence page with a short intro and an employee benefits guide PDF embedded below it in a viewer with page controls
A PDF embedded on the page rather than left as an attachment. Readers see the document where they already are and page through it in place.

The PDF embed (Capable) macro takes a PDF from one of three places. Pick the guide that matches where your file is.


#Common tasks

You want to

Go to

Show a PDF that is already attached to the page

Embed a PDF in a Confluence page

Show a PDF that lives on a website

Embed a PDF from a URL in Confluence

Upload a PDF and show it in one go

Upload a PDF and show it on a Confluence page

Show a PDF bigger than 2.5 MB

Embed a large PDF in Confluence

Compare the three sources

Three ways to supply a PDF

Know every setting

PDF embed

Fix an embed that will not load

Troubleshooting


#Guides in this section



The document where people already are.