Skip to main content

Messenger Connect Sharing

With the Messenger Connect Sharing badge you can allow your users to easily share content from your site with their Windows Live friends. This functionality is open to all web sites now: you do not need to be in the beta program.

There are two types of content that you can share with Messenger Connect:

  1. Article : This will include a page summary containing a thumbnail, page title, and description.
  2. Video: This will provide in-line playback of the shared video from within the page summary.

How to Implement

Paste this code into the page on your site:

<a href="http://profile.live.com/badge?url={your URL}" title="Share with Messenger"><img style="border-style:none; vertical-align:middle; margin-right:4px" src="http://js.live.net/static/img/SharingBadge16x16White.png" alt="Share with Messenger" />Messenger</a>

The Messenger badge comes in two sizes, 16x16 and 22x22 pixels. Each size provides both a white and orange background. The file names are SharingBadge16x16White.png, SharingBadge22x22White.png, SharingBadge16x16Orange.png, and SharingBadge22x22Orange.png, respectively.

The {your URL} variable in the code above can be constructed for either an article or a video, as follows:

Sample URL for an article

http://profile.live.com/badge/?url= http%3A %2Fwww.contoso.com%2Farticle.htm&title=Article%20title&description=Article%20description&screenshot=http:%2F%2Fwww.contoso.com%2Fimg%2Fimage1.jpg

Sample URL for video

http://profile.live.com/badge/?url= http%3A %2F%2Fwww.contoso.com%2Fvideo.htm&title=Video%20title&description=Video%20description&screenshot=http:%2F%2Fwww.contoso.com%2Fimg%2Fimage1.jpg&swfurl=http:%2F%2Fwww.contoso.com%2Fvideo.flv&height=340&width=500&ctype=flash

The table below summarizes the required and optional parameters for the URLs.

NameRequired?Query string parameterTypeDescription
URLYurlstring, max 512The URL being shared
thumbnail URL screenshotstring, max 512URL to the image to be used as the thumbnail in the activity stream
page titleYtitlestring, max 512Title of the web page
page description descriptionstring, max 512Description of the web page
embed sourceY for Video URLswfurlstring, max 512URL to the video source
embed height heightint, 1-9999Height of the video
embed width widthint, 1-9999Width of the video
embed type ctypeenum

Type of embed. The following values are currently supported:

-         flash

embed variables emvstring, max 128

Additional variables for the embed object. Will be used differently based on embed type:

-         flash: used as the ‘flashvars’ attribute

message msgstring, max 512The default user message. The user will be able to edit this.