Get the high-level details you need to set up your Confluence Cloud site in order to meet your team's needs.
Learn how to create great content and organize it.
Learn how to collaborate on pages and blogs, get notified about activity, and view analytics to see how content is performing.
Adjust settings around who can see what content on your site and what actions they can perform on it.
Find everything a site admin needs to know to keep their Confluence Cloud site running smoothly.
Get an overview of all the ways you can extend your Confluence content using macros and gadgets.
This macro was intentionally excluded from the new editor and will be deprecated from the legacy editor soon. Read the announcement for more.
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 many audio and video files. This is handy when you want to play a video in a larger format.
To add the Multimedia macro:
When editing , select from the toolbar
Find the item to be inserted and select it
You can also type / on the page to bring up the same list you'd see by selecting from the toolbar.
To edit the Multimedia macro:
Select the macro placeholder. The floating toolbar appears.
Select Edit. The right panel opens.
Modify the parameters. Your changes are saved as you go.
Resume editing the page, and the panel closes.
Drag a supported multimedia file directly onto your page, and Confluence will attach the file and add the macro for you.
Parameters are options that you can set to control the content or format of the macro output.
If the parameter name used in Confluence Cloud storage format or wikimarkup is different than the label used when inserting macros using the browser or the slash command, it will be listed below in brackets (example).
Parameter description and accepted values
Page name (page)
The 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 of the attached multimedia file.
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.
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.
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 set to false then the file will not play until the user clicks the icon or image on the page.
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: multimedia
Macro body: None.
Was this helpful?