Confluence 5.6 has reached end of life
Check out the [latest version] of the documentation
Using multimedia files you can display movies, animations and videos, and embed audio files on your Confluence page.
There are several methods for attaching files to a page. Once you have attached the multimedia file to a Confluence page, you then edit the page to set where the multimedia content should appear.
In the example below, we display a Flash file that is attached to this page.
Confluence supports the following multimedia formats:
On this page:
Related pages:
Quick guide to displaying multimedia content on a page
Choose one of these methods:
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:
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:
Speeding up macro entry with autocomplete: To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.
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:
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:
Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example
).
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. |
Advanced users can try styling via CSS. By default, each embedded object is wrapped in a div
tag. If you wish to style the div
and its contents, override the embeddedObject
CSS class. Specifying an ID as a property also allows you to style different embedded objects differently. CSS class names in the format embeddedObject-ID
are used.