Skip to content

Plugins in Livespace

A plugin embeds an external web application as an <iframe> widget inside a Livespace profile — Deal, Company, Person, or Space. The widget receives the current record's data and, when needed, temporary Livespace API credentials over the browser postMessage API.

This documentation is for developers building or configuring the embedded application.

How it works

  1. An account administrator registers a plugin with a name and an HTTPS URL, then configures which profiles display it, where, its size, and who can see it.
  2. When a user opens a supported profile, the widget loads in the configured position and receives the current record's data via postMessage.
  3. Your application reacts to that context and renders accordingly.

Where to start

  • Security — HTTPS, domain allowlist, iframe sandbox, and origin validation your application must comply with.
  • Context Messages — the data Livespace sends to your widget and how to receive it.
  • API Credentials — optional temporary credentials for calling the Livespace API.
  • Widget Environment — widget sizes, placement, and responsive-design guidance.