Keep'emKeep'em
Embedding

Embedding Overview

Keep'em's embeddable widget lets you add interactive video to any web application. A single script tag gives your users a full interactive video experience without leaving your platform.

Why Embed

Hosted pages work well for standalone webinars and public events. But for SaaS onboarding, product tutorials inside your dashboard, or any context where viewers are already in your application, embedding is the better approach.

Embedding means:

  • Viewers don't leave your application
  • Authentication is seamless (no separate login)
  • Display behavior is intelligent (show/hide based on viewer progress)
  • The experience feels native to your product

How It Works

  1. Add the widget script to your page with your publishable API key and event ID
  2. Call Keepem.identify() with the current user's identity
  3. The widget handles everything: registration checks, video display, chat, and progress tracking

The widget communicates with Keep'em's API to determine what to show each viewer. If they've already completed the video, nothing is rendered. If they haven't, a modal appears with the full player experience.

Authentication Model

The widget uses a two-token model:

  • Publishable API key (pk_live_...) — Identifies your project. Included as a data-key attribute on the script tag. Safe for client-side use.
  • Session token — Created automatically when the widget identifies a viewer, or by your backend via the API when pre-registering viewers.

See Widget Setup for implementation details.