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
  
  

Using the Widget Connector

To add the Widget Connector to a page:

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

Speeding up macro entry with autocomplete:

• In the new editor - Type / and the beginning of an element (tool or things in the insert menu) to see a list of suggestions.
• In the legacy editor - Type { and the beginning of the macro name to see a list of suggested macros.

Details are in Keyboard shortcuts, markdown, and 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.

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

Examples

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.

YouTube

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.

Vimeo

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.

Flickr

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.

Twitter

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.

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

SlideRocket

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.

Troubleshooting

If the Widget Connector can't display content from the external site, the macro will look like this:

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

Macro name: widget

Macro body: None.

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