Support for Embedded Experiences
Added by IBM contributorIBM | Edited by IBM contributorPaul Bastide on August 19, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Simply put, embedded experiences are a means of specifying a Gadget that can be used to interact with an Object that is present in the Activity Stream (or in fact. in other contexts too for example embedded in an email). In the case of the Activity Stream, this Gadget will be invoked and displayed on selection of an event.

For developers interested in Embedded Experience support on IBM Connections Cloud, you should visit the Working with Activity Streams in the Cloud article

In general then the gadgets purpose can be differentiated from that of the activity stream in general as follows:

  •  Activity Stream details : The detailed content of the activity is true at the time of the event's posting and follows strict and limited syntax and semantics allowing us to provide a common experience across a range of events.
  •  Embedded Experience : The embedded experience allows interaction with the current content in any manner that the creator of the embedded experience sees fit.

Adding the Embedded experience to the Activity data model

The embed property can be added to the event directly. This in turn contains two properties:

  • gadget - this is the URL of the XML file that defines the gadget
  • context - this is any javascript object that will be passed to the specified gadget to provide context


"id": "d350f68d-d835-49eb-b063-f1929ad5beb9",

"title": "Status update",

"verb": "post",

"openSocial" : {

"embed": {

"gadget": "",

"context": {"id":"12345"}



"actor": . . . ,

"object": . . . ,



Implementing the Embedded experience

See Open Social documentation for implementing a Gadget here ->