Confluence can display Office files that are attached to a page. If you have an Office application installed, you will also be able to edit these Office files in your Office application. These are two of the ways that Confluence can interact with Office files. For an overview of all Office Connector features, please refer to Working with the Office Connector.
|
Prerequisites
If you want to use the View File macro, or to view Office files attached to a Confluence page, you need the setup described below.
Browsers and Flash Player
You can use any browser to view an Office file on a wiki page or attachment view, provided that you have installed Adobe Flash Player version 9 or later. You do not need to have an Office desktop application installed on your computer in order to view Office files in Confluence.
File Types
Confluence can display files compatible with Microsoft Office 97-2007, and PDF files, of the following types:
.docand.docx.xlsand.xlsx.pptand.pptx.pdf
Attaching and Displaying Office Files and PDF Files
There are two ways to do this in Confluence:
- Attach Office files to a page and display them in a Confluence page using the View File or Attachments macros
- Attach an Office or PDF file to a page and embed its contents onto the page by simply dragging and dropping it into the editor window
To attach and display Office files in Confluence using macros:
- Attach the Office file(s) to a Confluence page:
- View the Confluence page on which you want to display your document.
- Choose Tools > Attachments.
- Browse for your Office files and upload them to the Confluence page.
Refer to detailed instructions in Attaching Files to a Page.
- Now you have two options for displaying the attached document:
- You can embed the document into the Confluence page, using one of the Office Word, Office Excel, Office PowerPoint or View PDF macros. These macros can be found using the macro browser. Refer to the detailed instructions in the View File macro topic.
- You can display a list of page attachments using the Attachments macro. People viewing the page will be able to click the View link to see the Office or PDF document in Confluence.
To attach and display an Office file on a Confluence page using 'drag and drop':
- Drag the Office file from your computer and drop it into the editor window. Only one file can be dragged and dropped at a time. The appropriate View File macro placeholder will appear in the position where you dragged the file. However, the contents of the file will be rendered in full when you preview, or save and view, the page.
Older browser versions require Google Gears to have been installed for you to use drag and drop. Refer to Using Drag-and-Drop in Confluence for information about setting up Google Gears.
Viewing and Editing the Attached Office Files
If an Office document is attached to a Confluence page, you can view the attached Office document from within Confluence. View the Office document in one of the following ways:
- Search for the Office document by file name, then click View next to the Office document on the Search results page. (See Searching Confluence.)
- View the list of attachments for a specific Confluence page, then click View next to the Office document on the Attachments page. (See Viewing Attachment Details.)
- View a list of attachments displayed on a page via the Attachments macro, then click View next to the Office document in the list of attachments. (See Displaying a List of Attachments in a Page.)
- View a Confluence page which has the Office document embedded in the page via the View File macro. (See View File Macro.)
Any Confluence user who has an Office application installed will also be able to launch their Office editor from within Confluence:
- Editing an Office Document from Confluence.
- Editing an Office Presentation from Confluence.
- Editing an Office Spreadsheet from Confluence.
Troubleshooting
Problems? Please refer to our guide to the Office Connector limitations and known issues.
Related Topics
View File Macro
Working with the Office Connector
- Office Connector Prerequisites
- Displaying Office Files in Confluence
- Importing an Office Document into Confluence
- Editing an Office Document from Confluence
- Editing an Office Spreadsheet from Confluence
- Editing an Office Presentation from Confluence
- Installing the Firefox Add-On for the Office Connector
Configuring the Office Connector in the Confluence Administration Guide
Take me back to the Confluence User's Guide.








20 Comments
Hide/Show CommentsAug 17, 2009
Anonymous
Two usability critiques:
(edited)
Aug 17, 2009
Giles Gaskell [Atlassian Technical Writer]
Hello there,
If you haven't already done so, you can log a feature request for these at our JIRA site. You can vote on an issue to improve its chances of being included in a future release of Confluence.
Best regards,
Giles Gaskell
Technical Writer
ggaskell@atlassian.com
ATLASSIAN - http://www.atlassian.com
Nov 30, 2009
Anonymous
Is there any way we can display an MS Office document without first attaching the file?
I have many MS Office documents located on a SharePoint site that I would like to be rendered on the Confluence wiki. Is this possible?
Jan 04, 2010
Azwandi Mohd Aris [Atlassian]
I am afraid that this is not possible with the current feature set in Confluence. Perhaps, you might want to raise a feature request in our issue tracker, if you are keen on it. Alternatively, you may raise it in our SharePoint Connector issue tracker.
Feb 16, 2010
Mark
Will there be support for Microsoft Project ? I am finding no references to project with search in plugins or in docs here.
A service called projec.to seems to be rendering project files in flash, not sure how it works but could be interesting to offer that here.
Feb 22, 2010
Sashidaran Jayaraman [Atlassian]
Hi Mark,
As far as I know, this feature is not currently available in Confluence. However, I have found a similar feature request. Please add yourself as a watcher, vote for this feature and add your own comments to this feature request. It would also be worth it to do the same for this feature request since they are related. For further details on how we include new features and improvements, you might want to read this page
Cheers
JSashi
Mar 10, 2010
Doug Bloch
I would like to view the content of an attachment in Confluence, below is what I am using
And it works if the file is attached to the same page.
What if I want to add the attachment to a parent page, how can I reference it the attachment. The ^ does not work.
Thanks in advance
Mar 10, 2010
Mark Hrynczak [Atlassian]
Hi Doug,
You just need to add in the 'page' parameter, as documented here.
So for example, try:
{viewxls:name=Example Workbook.xls|sheet=Sheet 1|col=4|row=1000|page=PageTitle}If the page containing the attachment is in a different space, you would also need the 'space' parameter.
Cheers,
Mark
Mar 11, 2010
Doug Bloch
Mark, Thanks I totaly missed the page parameter works great. The client is running Confluence 3.0.0_01, from the documentation it states the viewxls supports Office 2007 documents specifically .xlsx extension.
When I use
I get
viewxls: The viewfile macro only supports pdf, doc, xls, and ppt file types
Mar 11, 2010
Zed Yap [Atlassian]
Hi Doug,
I am afraid that the Office 2007 file is only supported in Confluence version 3.1 and above.
Hope that helps.
Best rgds,
Zed
Oct 18, 2011
Zornitsa Serafimova
Hi,
I am using this line for attaching and viewing excell
viewxls:name=example.xls|sheet=sheet 1|row=21|col=11
When I save however it gives me error:
Unknown macro:
May 24, 2010
Antony Dilip Amalraj
Hello,
The Drag and Drop option seems to be a great feautre in Confluence Wiki. At present, we are using Confluence 3.0.2. Is the Drag and Drop option of the attachments is available in this version 3.0.2 ?
A quick reply on this is appreciable.
Thanks!
Cheers,
Antony
May 24, 2010
Mark Hrynczak [Atlassian]
Hi Antony,
Sorry, drag and drop is not available in 3.0.2. The feature was introduced in 3.1, so you'll need to upgrade.
Cheers,
Mark
May 24, 2010
Antony Dilip Amalraj
Many Thanks Mark for your quick reply.
Cheers,
Antony
May 24, 2010
Antony Dilip Amalraj
Mark,
We are commercial customer of the Confluence Wiki version 3.0.2. At present we do not have any version upgrade plans. Is there any other ways to include this feature to our production. Can we ask for a patch to include this feautre to confluence3.0.2 in support.atlassian? This Feature would be useful to all our users.
Thanks for your help.
Cheers,
Antony
May 24, 2010
Mark Hrynczak [Atlassian]
You're welcome to raise an issue to ask.
I don't know how simple it would be to provide a patch - I suspect that Support will ask you to consider upgrading instead. That way you would be using a stable, tested release, and would also benefit from additional features and bug fixes that were implemented in 3.1.
Cheers,
Mark
Jul 05, 2010
Harvey Moore
We're trying to integrate our document control system into Confluence and want to turn off the "Edit Document" icon in the top right of some of our office connector macros. Is this possible? I've looked through all documentation, but nothing to suggest that it is.
I know that we can edit the permissions of the page, but this would have to be done on a page by page basis and time consuming, so not really an acceptable solution at the moment.
Jul 27, 2010
Sashidaran Jayaraman [Atlassian]
Hi Harvey,
You can hide the "Edit Document" button globally by going to Dashboard > Administration > Look and Feel > Custom HTML > At end of the HEAD and insert the following:
Hope this helps.
Cheers
JSashi
Apr 26, 2011
Anonymous
Thanks Sashi! I have been looking for a way to do this and your post was the first real solution to this problem.
Cheers,
Vikas
Jan 06, 2012
Matthijs ten Kate
What will it take to get .odt, .ods and .odp support (for viewing) in Confluence? I was actually a bit surprised that an 'open minded' company like Atlassian (still) doesn't support the most open document format on the planet... Now my colleagues have yet another reason to stick with MS Office...
Add Comment