A note on the Excel macro

We've received feedback that the Excel macro doesn't meet expectations in some cases. There are some known issues with it right now, which are detailed below. So why are we proceeding with the rollout? We're making infrastructure changes for the overall benefit of Confluence users, but they mean that we can't keep the old Office and PDF macros working much longer. We need to proceed with the rollout so we can move forward with the infrastructure changes that have a much wider impact than this macro.

In saying that, we, of course, genuinely care about every user's experience with Confluence, and always want it to be the best. If you're having real trouble with the new file viewer in the Excel macro, comment on this issue and let us know. There unfortunately isn't a short-term fix, as we do need to move off the old Excel macro, but we'll keep working on a better solution for the Excel macro.

The Office Excel macro displays the content of an Excel spreadsheet on a page. First attach the spreadsheet to a page, then use the macro to display the content. When viewing the page, people will see the content of the spreadsheet, without needing to have Office installed.

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.



Parameter nameRequiredDefaultParameter description and accepted values

The file name of the Excel spreadsheet 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 Excel spreadsheet 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: viewxls

Macro body: None.

{viewxls:page=Docs|name=My document.xls}