Multimedia Macro

Still need help?

The Atlassian Community is here for you.

Ask the community

Use the multimedia macro to embed attached video, animation, and other multimedia files to your page. The macro uses the HTML5 <video> tag, so the type of video your page viewers can see depends on the video formats their browser supports with the HTML5 <video> tag. For example, Quicktime videos (.mov or .qt) can only be viewed in Safari, as that file type is not supported by other browsers. 

 

If you want to display online multimedia content, like YouTube and Vimeo videos, take a look at the Widget Connector Macro.

The file preview also supports MP3 audio and MP4 video files. This is handy when you want to play a video in a larger format.

 

To add the Multimedia macro to your page:

  1. In the Confluence editor, choose Insert > Other Macros
  2. Find and select the required macro

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Autocomplete for links, files, macros and mentions.

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.

tip/resting Created with Sketch.

Drag a supported multimedia file directly onto your page, and Confluence will attach the file and add the macro for you. 

 

Parameters

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 name

Required

Default

Parameter description and accepted values

Page name (page)NoCurrent pageThe name of the page to which the multimedia file is attached. Start typing the name of the page and then select it from list of suggested pages. Include the spacekey if you want to specify a page in another space (for example, MYSPACE:My Page Title)
File* (name)YesNoneFile name of the attached multimedia file.
WidthNoIf 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.
HeightNoIf 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 (autostart)NofalseIf 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 set to false then the file will not play until the user clicks the icon or image on the page.

Code examples

The following examples are provided for advanced users who want to inspect or edit the underlying markup for a Confluence page. 

Macro name: multimedia

Macro body: None.

Storage format example

<ac:structured-macro ac:macro-id="4a589028-09cc-45ed-b8e8-d0ab1e9c0523" ac:name="multimedia" ac:schema-version="1">
	<ac:parameter ac:name="name">
		<ri:attachment ri:filename="myVideo.mp4" />
	</ac:parameter>
	<ac:parameter ac:name="width">600</ac:parameter>
	<ac:parameter ac:name="autostart">true</ac:parameter>
	<ac:parameter ac:name="height">430</ac:parameter>
</ac:structured-macro>

Wikimarkup example

{multimedia:space=DOC|page=My macros|name=ninjas.swf|autostart=true}

Last modified on Apr 12, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.