• Products
  • Documentation
  • Resources

Insert the widget connector macro

Embed online videos, slideshows, photostreams and more directly into your page with the Widget Connector macro. 

The macro currently supports content from these sites:

  • YouTube

  • Vimeo

  • Flickr

  • Twitter

  • Slide Rocket

To embed Google Drive files into a page, use one of the Google Drive macros instead.

Use the Widget Connector

To add the Widget Connector macro:

  1. When editing, select from the toolbar

  2. Find the macro by name and select it

  3. Configure it as needed

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar. Continue typing the name of the macro to filter the list.

To edit the Widget Connector macro:

  1. Select the macro placeholder.

  2. Select the Edit icon to open the configuration panel.

  3. Configure the parameters. Your changes are saved as you go.

  4. Resume editing the page, and the panel closes.

You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan iconto remove the macro.


Parameters are options that you can set to control what and how content from the macro appears on the page. 

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).



Web Site's Widget URL

This is the external site's URL. In some sites this will be the URL shown in the address bar of your browser, and in other sites you may need to click a Share or Link button to get the URL.

Pixel Height (Value Only)

The height of the display, in pixels.

Pixel Width (Value Only)

The width of the display, in pixels.


Every site is a little different, so we've put together some info on what you'll need to do to embed each site's content on a page.


The fastest way to embed a YouTube video is to paste the URL into the editor. Confluence will autoconvert the link and insert the macro for you, like magic.   Autoconvert works with both long and short YouTube URLs. 

If you're pasting the URL into the Widget Connector macro URL field manually, you'll need to use the long URL (from the address bar). Long URLs look something like this https://www.youtube.com/watch?v=k6lK5hlB1nQ.

  • If you're not able to see the video in some browsers, try using https rather than http in your link.

  • Links that contain a parameter to start a video at a particular time won't autoconvert or work in the Widget Connector macro, like this link: https://www.youtube.com/watch?t=15&v=LhHKkodOPFo. Paste in the short sharing URL to be sure it works.


The fastest way to embed a Vimeo video is to paste the URL into the editor. Confluence will autoconvert the link and insert the macro for you. 

You can use the URL from the address bar in your browser or the Share button in Vimeo.


You can embed a single photo, a set, an entire user's photo stream or collection of photos with a particular tag.

The fastest way is to paste a URL into the editor. This works for sets and tags.  For other URLs you'll need to add the Widget Connector macro to the page first and then paste your link into the URL field. 

Use the URL from the address bar in your browser.

See how the widget connector macro previews a Flickr URL


To embed a single tweet you'll need to click the Details link on the tweet so you can grab the URL for just that tweet.  The URL will look something like https://twitter.com/atlassian/status/346976521250037760.

See how the widget connector macro displays a Twitter URL


To embed a dynamic list of tweets you'll need to create a Widget in Twitter first:

  1. In Twitter, click your profile picture and go to Settings > Widgets

  2. Create a "Search" widget to display the tweets you want to embed (search by hashtag or handle, for example)

  3. Save the widget, then hit Edit and copy the page URL (from your address bar). 
    The URL should look like this: https://twitter.com/settings/widgets/354381809263472640/edit
     Do not copy the code Twitter tells you to copy and paste into the HMTL of your site, this will not work with the Widget Connector.

  4. In Confluence, paste the URL into the Widget Connector, but delete the /edit on the end of the URL

See how an embedded list of tweets looks using the widget connector macro



We don't autoconvert SlideRocket presentations, so you'll need to add the Widget Connector macro to your page first, and then paste the video's URL into the URL field. 

You can get the URL from the Sharing button on the SlideRocket player.


We rely on the external website's APIs to display content in the Widget Connector macro. APIs do change from time to time and this can cause the Widget Connector macro to stop rendering content. 

If you have trouble with the widget connector, you can open a support ticket to let us know.

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: widget

Macro body: None.

1 2 3 4 {widget:height=400|width=400|url=http://youtube.com/watch?v=23pLByj_q5U}

Still need help?

The Atlassian Community is here for you.