The PDF macro displays the content of a PDF document on a page. First attach the document to a page, then use the macro to display the document.

tip/resting Created with Sketch.

Edit files with your desktop apps

Use the apps on your computer to edit files stored in Confluence. Click on the file, then hit Edit with at the top and download the Atlassian Companion app*. After that, you can edit and automatically re-upload edited files to Confluence. Check out Edit files for all the details.

*The Companion app will be removed from Confluence at the end of March 2022. You won’t be able to edit files using the app after that date.

Use the PDF macro

To add the PDF macro:

  1. In the Confluence editor, select  > View more
  2. Find the item to be inserted and select it
  3. Select Insert

You can also type / onto the page to bring up the same list you'd see by selecting from the toolbar.

To edit the PDF macro:

  1. Select the macro placeholder. The floating toolbar appears.
  2. Select Edit. The right panel opens.
  3. Modify the parameters. Your changes are saved as you go.
  4. Resume editing the page, and the panel closes.


Parameter nameRequiredDefaultParameter description and accepted values

The file name of the PDF document to be displayed. The document must be attached to a page on your Confluence site.

pageNoThe page containing the macroThe name of a Confluence page to which the PDF document is attached.

Wiki markup example

Wiki markup is only supported in the legacy editor.


Wiki markup is useful when you need to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.

Macro name: viewpdf

Macro body: None.

{viewpdf:page=Docs|name=My document.pdf}