Using multimedia files you can display movies, animations and videos, and embed audio files on your Confluence page. In the example below, we display a Flash file that is attached to this page. Confluence supports the following multimedia formats:
|
| Quick guide to displaying multimedia content on a page Choose one of these methods:
|
Displaying a multimedia file attached to the page
Once you have attached a multimedia file to a page, there are different methods for choosing where on the page the multimedia content should appear:
Inserting the Multimedia macro yourself
You can add the Multimedia macro to the page yourself using the Macro Browser. This allows you to display a multimedia file that is attached to either the current page or to another page in the Confluence site.
To insert the Multimedia macro on the page at the current cursor position:
- In the Confluence editor, choose Insert > Other Macros.
- Find and select the required macro.
Using autocomplete
Once a multimedia file is attached to the page, you can use autocomplete, while editing the page, to choose where the multimedia content should appear.
To position an attached multimedia file on the page using autocomplete:
- While editing the page, position the cursor where you want to place the multimedia content.
- Trigger the autocomplete function by typing '!'.
- Choose the multimedia file from the list that appears.
- If necessary, click on the Multimedia macro placeholder and choose Edit to set various options such as the width, height or autoplay.
Using drag-and-drop
Depending on the browser you are using, you can attach and position a multimedia file in one step using drag-and-drop.
To attach and position multimedia content using drag-and-drop:
- While you are editing a page, simply drag-and-drop the multimedia file on to the page. Confluence will attach the file to the page and insert the Multimedia macro at the current cursor position for you.
- If necessary, click on the Multimedia macro placeholder and choose Edit to set various options such as the width, height or autoplay.
Multimedia macro parameters
When editing, you can click on the macro placeholder and choose Edit to display the parameters for this macro in the Macro Browser.
Parameters are options that you can set for Confluence macros to control the content or format of the macro output. The table below lists parameters for this macro that can be set in the Macro Browser.
Parameter | Default | Description |
|---|---|---|
Page Name | Current page | Name of the page to which the multimedia file is attached. If you are using the Macro Browser, just start typing the name of the page and then select it from the dropdown list that appears. The page can be in the same space or another space. |
Attachment | None | File name of the multimedia file. |
Width | If not specified, the browser will determine the width based on the file type. | Width of the movie window to be displayed on the page. By default, this value is specified in pixels. You can also choose to specify a percentage of the window's width, or any other value accepted by HTML. |
Height | If not specified, the browser will determine the height based on the file type. | Height of the movie window to be displayed on the page. By default, this value is specified in pixels. You can also choose to specify a percentage of the window's height, or any other value accepted by HTML. |
Autoplay | False | If this option is checked (that is, if the parameter is set to 'true') then the video or audio file will start playing as soon as the page is loaded. If this option is not checked (set to 'false') then the file will not play until the user clicks the icon or image on the page. See the note about autoplay below. |
Notes
- The multimedia file must be attached to a Confluence page. For security reasons, files located on remote servers are not permitted. See the Widget Connector for displaying live content from external sites.
- You will need the relevant multimedia plugin for your browser. Your browser (Firefox, Internet Explorer, Safari and others) needs a plugin to play the video or audio file on a Confluence page. For example, to play a Flash movie you need the Flash plugin. Many plugins are shipped with the major browsers by default. If a user does not have the required plugin installed and enabled in their browser, they will not be able to view the multimedia files on the page.
- Autoplay may not always work as expected. You can set autoplay on, so that your video or audio file should start playing as soon as the page is loaded into the browser. (See parameters.) However, this setting may not always work as expected. Confluence will send an instruction to the browser plugin that plays the multimedia file. Different browsers and different media plugins behave in different ways, and not all of them respect such instructions.
- Use the Office Connector to display Office documents. Take a look at the Office Connector for embedding Word documents, presentations and other Office documents onto your Confluence page.
- If you get the error, 'Unable to embed content of type application/octet-stream', this means the MIME type is not recognised.
- Advanced users can try styling via CSS. By default, each embedded object is wrapped in a
divtag. If you wish to style thedivand its contents, override theembeddedObjectCSS class. Specifying an ID as a property also allows you to style different embedded objects differently. CSS class names in the formatembeddedObject-IDare used.
Related Topics
Working with Macros
Widget Connector Macro
Working with the Office Connector
Working with Attachments
Take me back to Confluence User's Guide








83 Comments
Hide/Show CommentsOct 17, 2006
Jeroen Keppens
Our confluence is on https. When we embed a flash file, we get the message "This page contains both secure and nonsecure items. Do you want to display the nonsecure items."
I uploaded the files trough attachments. They are in the same location as the images. The images don't give the problem, only the flash files.
Any ideas?
Oct 17, 2006
Jeroen Keppens
I found this on the macromedia site: http://www.adobe.com/cfusion/knowledgebase/index.cfm?id=tn_16588
Unfortunately I can't change the codebase since I use the !testfile.swf! annotation...
Dec 19, 2007
Andy Brook
just passing... The solution to this is store all referenced media (images, css) that are loaded in the page, over ssl. in non-ssl mode, there will be no complaint over mixed source content (page from http, resources from https).
use a packet capture tool like Wireshark to pull out trick resources, or load the page from https and check the source for http:// references...
Dec 11, 2006
David Demner
I can't figure out how to specify the codebase... If I try to attach the file and refer as this:
!blah.vsd|type=application/x-visio,classid=clsid:279D6C9A-652E-4833-BEFC-312CA8887857,codebase=vviewer.exe!
It doesn't resolve to the proper link for the codebase (although the blah.vsd is fine). But if I use the full http:// to the viewer, Confluence converts it into an href in the rendered page.
Jan 31, 2007
Jim White
After embedding a couple of Flash .swf's i'm noticing that they run slowly. My movies are running at 30 fps in Flash. Any ideas why this is happening or if installing the Flash macro would help here?
Cheers
Mar 22, 2007
Jeff Guthrie
When I embed a real media file on my page using this notation:
The movie window AND the playback toolbar is the listed size. How can I get around this as it looks goofy.
Oct 26, 2007
James Fleming [Atlassian]
Jeff, it looks like you'll have to ask Real about this.
I've been looking over their documentation for a support request on this very issue, and the only parameters available for controlling the playback window are the simple height and width.
I agree that it looks goofy, but unfortunately this is one thing over which we've no control. I'll be happy to stand corrected, but for now that's the best of my knowledge.
James
Feb 07, 2008
David Fleming
Jeff, have you tried altering the sizing attributes? I had to guess at a video I had embedded, and with some fiddling around, it played just fine and looked good too.
Feb 07, 2008
Jeff Guthrie
I actually have not played with this since. I have been using the Flash Macro and embedding Flash instead of Real Content. Thanks for the reply though!
Feb 11, 2008
David Fleming
Do you have problems adding text to a page that has embedded media? For some reason I can embed a QT Movie, but the editor won't show text without skewing the video into some tiny little pink, static square in the upper left corner of the page.
??
Apr 29, 2008
Anonymous
Hi David, Have you figured this issue out? If so, how do I set video sizes so they quit defaulting.
Apr 26, 2007
Colin Ho
FYI, I have opened CONF-8345 requesting the removal of the restriction that "files located on remote servers are not permitted". Please vote for the issue if you agree.
May 09, 2007
Ben Truby
Is there any way to Embed, Display, or even Convert a PDF file for viewing on confluence?
May 09, 2007
Rosie Jameson [Atlassian Technical Writer]
Yes — you can attach a PDF file to any Confluence page, and create a link to it. Please see Working with Attachments Overview
May 10, 2007
Ben Truby
How about to view the PDF directly on the Confluence page, without needing to open an external instance of a pdf viewer. I have tried embedding it like other multimedia content, but it firefox tells me I need to install additional plugins (IE does nothing with it). I have Adobe Reader installed on my system.
Nov 25, 2009
Mat Gauvin [Appfire Technologies]
This is just a note to update this comment thread.
Embedding a PDF directly on a Confluence page is now possible in Confluence
Details are available here.
Sep 25, 2011
Ellen Feaheny [AppFusions]
See AppFusions' SharpView - including video and live demo of a displaying PDFs in high resolution in Confluence, among other features.
https://www.appfusions.com/display/SHRPVW/Home
May 11, 2007
Mohammed Alam
Unfortunately, there is no such feature to view a PDF document directly on a confluence page. A new plugin is required to put the PDF content into confluence page and currently there is no plugin available to embed this external software into Confluence page.
I would suggest you to create a feature request in Jira at http://jira.atlassian.com describing your requirement. Please feel free to add a watch and you can cast your vote for this feature there.
May 11, 2007
Ben Truby
Thank You.
Aug 27, 2007
Doods Perea
Most of our Confluence pages display content directly from the attached Word or Excel document(s) using Word/Excel macros. In some cases, we only want to display content from a particular page or worksheet, not from the entire document. Is there a way to do this?
Thanks.
Aug 28, 2007
David Perez
Any progress regarding the Mind Manager plugin? I've seen a couple of comments from users, but not sure if this went any further. Thanks!
Nov 14, 2007
Mark
Yes, mind manager maps very important for projects and for documentation
Dec 19, 2007
Andy Brook
Checkout the Freemind plugin which does a great job of loading freemind attachments and rendering in an applet. It works a treat - but no editing ability, think excel...
Sep 25, 2011
Ellen Feaheny [AppFusions]
See AppFusions' MindMapIt - including video and live demo for building MindMaps inside Confluence, among other features.
https://www.appfusions.com/display/MNDMPIT/Home
Aug 28, 2007
Corey McGarrahan
I have added an mp3 file - !song1.mp3! - but I do not want it to auto play so I changed it to - !song1.mp3|autostart=false! - but this did nothing. Any ideas on how or if I can get this to not autostart?
Nov 16, 2007
Stephen Danelutti
I'll second that. I'm trying exactly the same with wmv files and the autostart=false instruction just does not work
Nov 19, 2007
Choy Li Tham
Hi Corey,
I'm not aware of any workaround that could fulfill your requirement. However, if you are keen on this improvement, please raise an improvement request at our JIRA issue tracker:
Regards,
Choy Li
Nov 19, 2007
Stephen Danelutti
I've taken the liberty of raising an issue as you suggested Choy. Find it here
Feb 07, 2008
David Fleming
Ditto - did the same thing on a Quick Time movie, using QT attributes and it did not stop.
Jan 09, 2008
Anonymous
Has anyone been able to add a flash file and not have it play automatically? I've also tried the autostart=false with no luck. Is there a way to display the play controls as well?
Feb 11, 2008
Choy Li Tham
Hi,
Unfortunately, Confluence does not provide this feature currently. However, there is an improvement request pertaining to manage multimedia content in Confluence page being tracked at the following:
If you are keen on this improvement, feel free to cast a vote to increase its popularity and add yourself as a watcher for future updates.
Regards,
Choy Li
Feb 25, 2008
Anonymous
That bug is almost 4 months old and remains unassigned. Any idea if it's going to get looked at?
Feb 25, 2008
Choy Li Tham
Hi,
I can't possibly tell you the schedule on when our developer will fix the reported issues due to our commitment in getting the bugs fixed and other new implementations. However, you may check on the following link on the work in progress for:
I would suggest you to add yourself as the watcher of the improvement request as updates will be posted there and feel free to add any comments of your concern to the improvement request to truly reflect the importance of this improvement.
Regards,
Choy Li
Mar 03, 2008
Mel Bagnato
Not sure if I'm doing something wrong, but I can't get my flashfile to resize. It's coming up quite small and I'd like it to be at least 80% of the available screen size. Any tips ?
Mar 03, 2008
Choy Li Tham
Hi Mel,
It would be appreciated that if you could raise a support request at here pertaining to the problem that you are having. We will follow up and further investigate the problem from there.
Regards,
Choy Li
Jun 17, 2008
Anonymous
I raised this issue a few versions before and nothing was done. It really makes it tough to place a flash file. Each time I edit the page it resizes to the default that you guys set. I really want to have control on the flash file because sometimes I edit the page - the flash resizes and I forget to resize it back to my preferences.
Jun 18, 2008
Mei Yan Chan
Hi,
This plugin may come in handy for you:
Regards,
Mei
Oct 28, 2008
Steve Furness
I found that this problem occurs only if you edit your page in the rich text editor.
For some reason Flash Files default to a 32x32 pixel size
If you edit your page in Wiki markup instead I find it is perfect.
Mar 30, 2008
Anonymous
How do you attach an mp3 file so that it doesn't automatically play? because I have a number of mp3's attached and when you first get to my page the simple cacophony is enough to drive away most people
Apr 01, 2008
Tony Cheah Tong Nyee
Hi there,
We have a discussion regarding this at:
Feel free to participate in the improvement request.
Additionally, an mp3 file embedded in my local instance are played via the Quicktime player. Right clicking on the player enable you to choose the option "Plug-in Settings". From there, you are able to configure the autoplay option under the "Browser" tab. You might want to give a try with the configuration suggested there if your Confluence's page is using Quicktime player too.
Cheers,
Tony
Sep 14, 2008
Ruben Miranda
Try using this macro as a workaround to the autoplay bug:
http://confluence.atlassian.com/display/CONFEXT/Video+and+Audio+Embed+Macro+With+Autoplay+Disabled
May 07, 2008
Anonymous
When I embed a .mov quicktime video, and set the dimensions (|,align=center,width=640,height=480,AUTOPLAY="false",id=media!) then go back to edit the document, because it comes up editing in rich text first, it changes my dimensions to 32x32.... only by changing the dimensions each time can i keep it at the ones i specified first.
Help?
May 08, 2008
Fennie Ng
Hi,
I believe you are affected by the bug:
Feel free to add a watch to the issue so that you will be notified for updates.
Regards,
Fennie
May 07, 2008
Anonymous
When I embed a .swf into my wiki page, the playback toolbar doesn't show up. I realize I probably have to reference the skin file and/or the jscript, so I attached them to the page too but I have no idea how to get them on the page. Can anyone help me?
May 08, 2008
Fennie Ng
Hi,
Can you please create a support ticket at :
Once you have created the ticket, please attach a copy of your .swf, skin and jscript to the ticket for further investigation
Regards,
Fennie
May 12, 2008
Anonymous
my wmv file works great. However I have several wmv files I would like to play automatically one after the other. WMV allows you to put it into a playlist but pl files are not supported right? although they contain wmv files? Any ideas how I can play multiple wmv files without having to embedd them individually on on one page?
Thanks
Nana
May 13, 2008
Tony Cheah Tong Nyee
Hi Nana,
I am afraid this cannot be achieved in Confluence. Indeed, the embedded multimedia feature does not support *.pl or *.wpl extension. If you are keen with this feature, feel free to raise a feature request in our JIRA Issue Tracker at:
Cheers,
Tony
May 21, 2008
Anonymous
With regard to 508 compliance, videos need to have captioning. A type of windows media file .asx provides captioning but its not supported here. How can I get it to show? I think you should support all windows media files
May 22, 2008
Ming Giet Chong
Hi,
This feature is not supported in Confluence currently. However, if you are keen with this feature, feel free to raise a feature request in our JIRA Issue Tracker here. Thanks.
Regards,
MG
Sep 15, 2008
Pierre Estager
Hi !!
So nobody can help me to know how to activate the autoplay function to false ?
Sep 15, 2008
Azwandi Mohd Aris [Atlassian]
Hi Pierre,
I would suggest you to take a look at a user macro, written by Ruben Miranda at:
Hope that helps.
Cheers,
Azwandi
Sep 15, 2008
Pierre Estager
Hi !
Many thanks for the tip.
Unfortunatly, the video macro is not recognize by Confluence.
Anybody else has an answer to my autoplay issue ?
Sep 16, 2008
Azwandi Mohd Aris [Atlassian]
Hi Pierre,
The video macro is a form of user macros, which you have to create in the Administration Console, before you can use them in the wiki markup. In other words, you do not have to install a full plugin to utilise the macro. To learn more about user macros, please refer to this page. Hope that helps.
Cheers,
Azwandi
Nov 17, 2008
Anonymous
Hi- Anyone know how to load a DVD to a wiki? The file extensions are of type, BUP, IFO and VOB. The DVD starts automatically in CyberLink Power DVD. Any suggestions? Thanks!
Nov 19, 2008
Azwandi Mohd Aris [Atlassian]
Hi,
I am not aware of any plugins that can load a DVD into a wiki. However, if it is something embeddable or displayable using HTML tags, you can use the HTML macro that is bundled in Confluence.
Cheers,
Azwandi
Feb 03, 2009
Anonymous
Is there any way to make the size of an embedded pdf viewer variable, as in it scales with the size of the broswer window?
Feb 12, 2009
Komathi Krishnan [Atlassian]
Hi there,
If you are using {viewfile} macro, you might want to use the width and height variable to adjust the size. However we don't have the feature to auto adjust the size according to windows browser. Meanwhile, if you are keen with this feature feel free to raise a feature request on our JIRA Issue Tracker here. Thanks
Cheers,
Komathi
Feb 18, 2009
Peter R.
Are there any performance hits when streaming video from Confluence? Say an 18MB WMV file?
Mar 25, 2009
Azwandi Mohd Aris [Atlassian]
I think the situation depends on the streaming method (although I am not aware of any plugins that can provide streaming service). Otherwise, it can be regarded as downloading a normal 18MB attachment off Confluence.
Aug 19, 2009
Bronwyn Davies
I have attached an MP4 video file to a page but when I click on it, it opens as full screen in the same page in Firefox using Quicktime (which I have installed). I would like embed the video and have it play minimized within the Confluence page so people realise they are still within the Wiki. Changing the height & width make absolutely no difference. Any ideas how?
Aug 20, 2009
Bronwyn Davies
Thanks to Zed Yap(Atlassian)
Using the html macro to limit the size worked. As long as your height and width are larger than the video, it shows the controls.
Only problem is our "systems" guys are not happy about enabling the html macro - life goes on!
Aug 21, 2009
Zed Yap [Atlassian]
Hi Bronwyn,
You might want to use CSS style syntax to limit the size of the video. To do so you will need the html macro plugin. I have created an example below hopefully this might give
you more understanding on it:
Hope that helps.
Best rgds,
Zed
Jan 07, 2010
Miss Lulu
Happy 2010 Atlassian! Any news on fixing the issue for disabling autoplay for embedding multimedia content? This is a critical component that threatens to kill my upsell for Confluence within our Marketing department which needs to host hundreds of mp3's and .mov files. Every time we reload the page or edit, it launches every file simultaneously. This was something I was looking forward to seeing prioritized for the release of 3.1 but sadly it has not been. I'm waiting to open up to over 300+ users but cannot until this issue is resolved. Major bummer. Surprised you are not giving this more importance given the core business use for entertainment and media companies that need this functionality.
Jan 11, 2010
Anonymous
I agree! This problem needs a major fix as there's nothing more nerve wracking then having a page with multiple mp3's which are stuck in an 'auto-play' mode. Any chance on including this in your next release? This really is a big needed fix!
Mar 01, 2010
Sashidaran Jayaraman [Atlassian]
Hi guys,
Perhaps the workaround provided by Ruben Miranda could help for the time being. Basically, the workaround is to create a user macro that will stop the auto play, In order to create a new user macro:
Hope this helps.
Cheers
JSashi
Jan 15, 2010
Gina Wadley
I've figured this out for Adobe Captivate .swf movies. Please see my post on the Confluence user forum: Managing multimedia content in a Confluence page.
Aug 13, 2010
Anonymous
Info: Setting autoplay to false works for me with mov and wmv files like this:
wmv: !small.wmv|,align=center,width=320,height=240,autostart=0,id=media!
mov: !2009-12-08-02-2.mov|,align=center,width=320,height=240,AUTOPLAY="false",id=media!
Aug 25, 2011
Steve Goldberg
(removed)
Sep 09, 2010
Manikandan Lingi
My company uses Confluence 2.9. I have trouble uploading video contents more than 60 MB and most decent looking videos of 15 minutes length are at least 60 to 70 MB size. It becomes frustrating to upload them because it takes hell a lot of time to upload the file and many times the session freezes or crashes. I once succeeded in uploading a 16MB video but the page took a lot of time to load and the video did not stream smoothly.
The server is located at offshore for us and I am not sure thats the only reason. Would upgrading to 3.3 help? Like other users have mentioned, we have a number of video tutorial that we would like to post on our wiki and I just wanted to know is there any thing that out admin can do to improve performance.
Oct 04, 2010
Daniel Tkatch
I am trying to embed an SWF video into a JIRA task description like that:
!my-attached-video.swf!
but it doesn't work. The area is just white.
Nov 10, 2010
Anonymous
I created a little macro for embedding freemind mindmaps into a conlfuence page (everything on this page regarding mindmaps seems to be outdated).
You can get the macro and the instruction here:
http://s-weber.blogspot.com/2010/11/freemind-mindmaps-in-confluence-pages.html
Cheers
Jan 09, 2011
Andreas van Rienen
Stefan - thanks a lot for your effort. After having spend a long time searching for a "mind mapping solution" for Confluence, you made my day! Very much appreciated!!
And for everyone looking for some mind mapping data (.mm) to get a demonstration page running: check out WikiMindMap.org.
Best regards,
Andreas
Mar 21, 2011
Diane Sexton
The new multimedia macro will not find attached swf (flash) files if the filename has a ' in it.
We have files already embedded using the !filename.swf! notation and they work fine (autoplay and all) but when I changed them to use the new {multimedia} notation there was an error message: "multimedia: Cannot find attachment 'ninja's.swf'"
I've tried in our test 3.5 environment, by attaching the test swf file from this page with an apostrophe ' character in the filename.
I've logged a JIRA issue (with attachments for test) at CONF-22044
Apr 01, 2011
Andrea Carta
I am wanting to center .mov videos. They play ok but do not center. This is what I've tried:
Any suggestions?
Apr 07, 2011
Anonymous
HI!
Which Plugin have i to install for using multimedia macro?
cheers!
Apr 07, 2011
Sarah Maddox [Atlassian Technical Writer]
Hallo there
The Multimedia macro is bundled with Confluence 3.5 and later. No additional plugin installation required.
Cheers, Sarah
Apr 28, 2011
Anonymous
I'm using Firefox 4.0 and I have some problems with multimedia files (avi and wmv). Browser says that it needs a plugin, but I have all plugin installed. And browser can't find any "good" plugin to be installed. So maybe the problem is in Firefox 4.0. For example there are no Google Gears and Web DAV Launcher for this version of FF
Jul 06, 2011
Anonymous
The list of acceptable movie file formats (containers) should be the same in the Dialog box as it is in the Documentation link. In the dialog box, it lists swf, mov, wma, wmv, mpeg, mpg, ram, rm, mp3, and avi. In the documentation, it lists all these PLUS mp4. mp4 is pretty common, so it's a pain for the User to not be able to know that it's allowable unless he clicks on the Documentation hyperlink. m4v (which is not listed) is pretty common, too, so I think it would be helpful for not only the allowable formats to be listed, but also for the "definitely not allowed" formats to be listed.
Jul 29, 2011
Anonymous
Has anyone found a format and code that lets them embed a video that can be viewed by iphones?
Aug 23, 2011
Anonymous
Tip: If you can output a .flv flash video file and a .swf flash controller file (Camtasia, for example, spits these out when you produce a flash video) you can attach both of these to the page, and then use the multimedia macro with the .swf. It will play the .flv fine.
Aug 25, 2011
Steve Goldberg
Anybody know how to stop auto-playing?
Sep 13, 2011
Anonymous
Unfortunately, I don't think there is a way to stop the autostart. I haven't found one, and no one else seems to know of one. Adding "autostart='false'" does not work, at least not in IE or Firefox.
What I've done to get around it is to place an image of the player window on the page, and when a user clicks on it, a pop-up window launches with the video in it, which auto-plays, of course. This way you don't have the video auto-starting when the page is loaded. They must click on it to start it.
Dec 14, 2011
Anonymous
It's the first time I came here, and I found it powerful!
Add Comment